Retreaver es seguimiento de llamadas y enrutamiento por etiquetas (tags). Decide qué comprador gana una llamada y luego la envía a un destino. Apunte ese destino a su servidor de VICIfast y la llamada entra a un In-Group de VICIdial con las etiquetas adjuntas.
Retreaver publica integraciones con Everflow, MediaAlpha, Pipedrive y ActiveProspect, entre otras. No lista ninguna integración con marcadores, PBX ni centros de contacto. Ese vacío es la razón de esta página: el enrutamiento está documentado y es estable, pero nadie ha escrito cómo funciona el extremo de destino cuando ese destino es VICIdial.
Integraciones a pedido. No somos socios de Retreaver y no hay un conector que habilitar. Nuestro equipo lo conecta como un trabajo con alcance definido, cotizado por configuración.
Las etiquetas son todo el modelo
Retreaver adjunta etiquetas clave-valor a una llamada: el número marcado, la campaña, el publisher, lo que haya enviado el afiliado. Las reglas de enrutamiento se basan en las etiquetas. Todo lo útil sobre la llamada es una etiqueta antes de que llegue a usted.
Hay dos maneras en que esas etiquetas pasan al otro lado:
En la llamada, como encabezados SIP. Léalas en el dialplan con PJSIP_HEADER(read,...) y complete el lead antes de que aparezca la pantalla.
Antes de la llamada, como un webhook. Retreaver envía el conjunto de etiquetas a una URL que usted indica. Un endpoint lo recibe, llama a non_agent_api.php con function=add_lead o update_lead, y el registro existe antes de que llegue la llamada.
La ruta por webhook da más trabajo y es más robusta. Un carrier intermedio puede eliminar los encabezados; un POST HTTP llegó o no llegó.
Configuración
- Cree el In-Group y el skill de agentes que atenderá el tráfico.
- Cree el endpoint SIP o el DID al que apuntará Retreaver.
- Agregue el número como Target en Retreaver y vincúlelo a las reglas de enrutamiento de la campaña.
- Decida qué etiquetas le importan al agente y acuerde sus nombres.
- Mapee las etiquetas a campos de VICIdial, en el dialplan o en el endpoint del webhook.
- Pruebe con tráfico real y confirme que las etiquetas sobreviven todo el recorrido.
También funciona en sentido contrario
Todo lo anterior es tráfico que llega. El marcador también puede llamar a Retreaver: VICIdial llama a su API en plena llamada con el lead sustituido en la URL, y quien llama se transfiere en vivo si Retreaver acepta. Retreaver enruta por etiquetas, así que la aceptación puede indicar un destino distinto para cada comprador sin que usted cambie nada.
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
Mantener estables los nombres de las etiquetas es responsabilidad suya. Cambie el nombre de una etiqueta en Retreaver y el dialplan leerá una cadena vacía. No aparece ningún error; la pantalla del agente simplemente queda en blanco donde antes estaba el publisher.
Webhooks duplicados. Retreaver puede dispararse con más de un evento. Haga el endpoint idempotente según el identificador de la llamada, o creará dos leads para una sola llamada.
El tiempo límite de Retreaver frente a su tiempo de timbrado. Es el mismo problema de relojes que en todas las plataformas de llamadas. Su enrutamiento se rinde y prueba con el siguiente comprador mientras a su agente todavía le está sonando.
Relacionado: enrutamiento de pago por llamada en VICIdial.
