Primeros pasos
Conceptos clave
Los objetos
| Objeto | Qué es | Vinculado a |
|---|---|---|
| Agente | La voz con la que habla quien llama: idioma, voz, modelo, flujo de llamada y análisis tras la llamada. | Herramientas, un webhook, una entidad |
| Flujo de llamadas | El guion del agente como un grafo de nodos. El campo diagram del agente. | Su agente |
| Herramienta | Una función que el agente invoca en plena llamada: tu endpoint HTTP, una búsqueda web, un SMS, un email. | Los flujos de llamada que la referencian. Compartida por todas las entidades. |
| Número de teléfono | Una línea de la cuenta (SIP, Twilio o Telnyx). Atiende las llamadas entrantes con un agente y marca para las campañas. | Un agente, un trunk SIP, una entidad |
| Trunk SIP | La conexión con el operador detrás de los números SIP. Define el límite de llamadas por segundo. | Sus números |
| Campaña | Una tanda de llamadas salientes: un agente, un número, una cola de contactos a los que llamar. | Un agente, un número, contactos |
| Contacto | Una persona del CRM, identificada por su número de teléfono. Sus campos llegan al prompt del agente. | Campañas, llamadas |
| Llamada | Una conversación, entrante, saliente o desde un navegador, con su resultado, resumen, transcripción, grabación y coste. | Un agente, un número, una campaña |
| Webhook | Tu endpoint, que recibe los datos de fin de llamada de los agentes que tiene asignados. | Agentes, una entidad |
| Entidad | Una unidad de la cuenta (un club, un cliente, una consulta) que agrupa agentes, números y webhooks. | Agentes, números, webhooks |
| Factura | Una factura que CallShift emite a la cuenta. | La cuenta |
Ciclo de vida de una llamada saliente
En cola
Por cada contacto añadido a una campaña se crea una llamada con el estado
READY.Marcada
Cuando la campaña está activa, CallShift realiza la llamada desde el número de la campaña, respetando el límite de llamadas por segundo del trunk. La llamada pasa a
IN_PROGRESS.Terminada
La llamada termina con un estado y un
endedReason: contestada y finalizada, sin respuesta, buzón de voz, transferida.Analizada y entregada
CallShift completa el resumen, los flags de resultado y la información recopilada, y después envía toda la llamada al webhook del agente.
Ciclo de vida de una llamada entrante
Quien llama marca uno de tus números y contesta el agente asignado a ese número. CallShift busca su número en el CRM, para que el agente pueda saludar por su nombre a un contacto conocido y leer sus datos. A partir de ahí, la llamada se analiza y se entrega igual que una saliente, con type inbound.