Boberdoo entrega un lead ganado como una solicitud HTTP a una URL que usted indica. Apunte esa URL a su servidor de VICIfast y el registro entra a una lista de VICIdial, verificado contra DNC, listo para el hopper en su siguiente pasada. Boberdoo construye entregas en GET, POST, XML, SOAP o JSON, así que la forma la define usted.
Integraciones a pedido. No hay un conector de Boberdoo que activar, y no somos socios de Boberdoo. Nuestro equipo conecta su cuenta con su servidor como un trabajo con alcance definido, cotizado por configuración, porque el mapeo de campos y el manejo de rechazos cambian con cada comprador.
El ping y el post no son la misma entrega
La mayoría de los problemas de esta integración vienen de tratarlos como una sola cosa.
El ping es una solicitud de puja. Boberdoo describe un lead (estado, sector y, a veces, un identificador convertido en hash) y pregunta cuánto pagará usted. A propósito, sin datos personales (PII). No cambia de manos nada marcable.
El post es el registro en sí, enviado solo a quien ganó el ping.
Solo el post debería llegar a add_lead. Conecte un ping a su marcador y llenará una lista con registros que nunca compró y a los que legalmente no puede llamar.
Cómo llega el post a VICIdial
La entrega apunta a la API no-agente de VICIdial (non-agent API):
https://your-box/vicidial/non_agent_api.php
?source=boberdoo
&user=<api-user>&pass=<api-pass>
&function=add_lead
&phone_number=5551234567
&phone_code=1
&list_id=<list>
&first_name=&last_name=&address1=&city=&state=&postal_code=&email=
&vendor_lead_code=<boberdoo lead id>
&dnc_check=Y&campaign_dnc_check=Y
Tres campos llevan el peso:
vendor_lead_code guarda el ID de lead propio de Boberdoo. Sin él, no puede conciliar una tipificación con lo que le facturaron, y cada disputa de facturación se convierte en una búsqueda manual.
list_id es la decisión de enrutamiento. Una lista por fuente, por sector o por campaña del comprador: lo que piense reportar después. Cambiar de idea después de un mes de datos es doloroso.
dnc_check=Y depura al llegar y no al momento de marcar. Un registro que nunca se debió comprar nunca entra al hopper.
La respuesta que Boberdoo necesita
Boberdoo espera que su endpoint responda, y toma la respuesta como la aceptación o el rechazo. non_agent_api.php devuelve su propia cadena de éxito o de error, que no es la forma que pide la especificación de Boberdoo.
Esa diferencia es la integración. Un endpoint liviano se ubica delante, convierte el post en la llamada a add_lead y devuelve el acuse de recibo en el formato que define su especificación de Boberdoo. También es el lugar indicado para rechazar un registro mal formado antes de que llegue al marcador.
También funciona en sentido contrario
Todo lo anterior es tráfico que llega. El marcador también puede llamar a Boberdoo: VICIdial llama a su API en plena llamada con el lead sustituido en la URL, y quien llama se transfiere en vivo si Boberdoo acepta. Boberdoo ya devuelve un DID dinámico en la puja justamente para esto, así que la aceptación trae el destino consigo.
Una transferencia aceptada durante la conversación vale bastante más que un registro enviado después, y es un trabajo aparte de la ruta entrante. Vea transferencia en vivo según la respuesta de la API del comprador para conocer los hooks y los modos de falla.
Errores comunes
La especificación la escribe el comprador, no el vendedor. La propia documentación de Boberdoo deja claro que las especificaciones de ping-post las entrega el comprador. Es decir, usted. Si nadie de su lado ha escrito una, la integración no puede empezar, y la primera reunión trata de acordar los campos, no de la conexión técnica.
Los posts duplicados ocurren. Los reintentos, los envíos dobles y los reenvíos son normales. Elimine duplicados según vendor_lead_code antes de llamar a add_lead, o dos agentes llamarán dos veces a la misma persona.
El formato del teléfono. VICIdial quiere phone_number y phone_code por separado. Un post que trae +1 o guiones en un solo campo produce un lead al que el marcador, sin avisar, nunca llama.
La zona horaria sale del registro, no del servidor. VICIdial obtiene los horarios de llamada a partir del código postal del lead. Un post sin postal_code hereda un valor predeterminado y se le puede llamar fuera del horario permitido.
Llamadas en vivo, no solo leads web. El ping-post de Boberdoo también maneja llamadas, con compradores que devuelven un DID dinámico en la puja. Si ese es su modelo, se aplica el mecanismo de enrutamiento de llamadas: vea enrutamiento de pago por llamada.
