API de devolución de llamadas: llame a un cliente desde su sitio web
Un visitante deja su número, se llama primero a su equipo, luego al cliente, y se conectan ambos. Tarifas bajo presupuesto.
Bajo presupuesto
La devolución de llamadas permite que un visitante pida que le llamen. Escribe su número en un formulario y su aplicación envía una solicitud a la API.
TELQIO llama primero a la persona de su equipo encargada de la devolución. Cuando contesta, la plataforma llama al cliente y une las dos llamadas. El cliente solo recibe la llamada cuando hay alguien listo para atenderle.
Puede asociar un flujo de llamadas para gestionar las ausencias: horario, cola de respaldo, mensaje. Cada devolución conserva un estado legible: ringing, connected, completed o failed.
Cómo circula
Usos concretos
Solicitud de llamada inmobiliaria
Un comprador deja su número en un anuncio y un agente le llama en la hora siguiente.
Contacto en el sector del automóvil
Un visitante pide una prueba de conducción y el asesor inicia la llamada cuando está disponible.
Atención al cliente
Ofrezca una devolución de llamada en lugar de una espera al teléfono.
Cualificación de contactos
Devuelva a la mañana siguiente las llamadas de los formularios recibidos fuera de horario.
Funcionalidades
- Devolución iniciada por solicitud a la API
- Se llama primero al equipo y después al cliente
- Flujo asociado para horarios y casos de ausencia
- Estados de llamada legibles en cada etapa
- Registro de devoluciones por proyecto
- Eventos de llamada enviados por webhook firmado
Límites que conviene conocer
- La devolución exige un número de cliente válido y un país abierto a las llamadas salientes en su contrato.
- Una devolución genera al menos dos llamadas. Según el contrato, pueden dar varias líneas de consumo.
- Un cliente que no contesta o cuelga pronto no ha tenido una conversación, aunque la llamada haya sonado.
- La persona llamada debe estar informada de la devolución y haber dado su número con ese fin. La obligación exacta se determina según el servicio, el país y su papel.
curl -X POST "https://api.example.test/v1/calls" \
-H "Authorization: Bearer tq_test_EXEMPLE" \
-H "Idempotency-Key: 7b1d2c4e-0000-4000-8000-000000000004" \
-H "Content-Type: application/json" \
-d '{
"from": "+33199001234",
"to": "+33199001235",
"project_id": "proyecto_a",
"flow_id": "flow_devolucion_ejemplo"
}'
# => { "id": "call_ejemplo", "status": "ringing", "simulated": true }Aspectos técnicos
| Activación | POST /calls con un flow_id de devolución |
|---|---|
| Orden de las llamadas | Primero el equipo, después el cliente, luego la conexión |
| Estados | ringing, connected, completed, failed |
| Eventos | call.connected, call.completed, call.failed |
Preguntas frecuentes
¿Por qué llamar al equipo antes que al cliente?
Para que haya alguien listo cuando el cliente conteste. El cliente no queda esperando en una línea sin respuesta.
¿Qué pasa si nadie del equipo contesta?
El flujo asociado puede ofrecer una alternativa: otra persona, una cola o un nuevo intento. Sin alternativa, la devolución queda marcada como failed.
¿Puedo programar una devolución para más tarde?
Su aplicación decide cuándo envía la solicitud. La API inicia la llamada en cuanto la recibe.
Usos relacionados
Documentación
Servicios relacionados
Pongamos en marcha sus devoluciones de llamada
Describa su sitio, sus equipos y los países implicados. Preparamos un presupuesto y un ejemplo de recorrido.