¿Cómo recibo el resultado de cada llamada en mi sistema?

Objetivo: Configurar webhooks de notificaciones y verificar sus entregas.

Nivel: Avanzado · Duración: 3 min · Antes de esta lección: «¿Cómo disparo llamadas desde mi sistema con la API?»

Dónde, en Talkyria: app.talkyria.com/integraciones/api

Gancho

Tu CRM debería enterarse solo de cada confirmación, sin que nadie copie nada. Un webhook se lo cuenta en segundos, después de cada llamada.

Lo que vas a lograr

Vas a agregar una URL de webhook, elegir sus eventos, probarla, verificar su firma y revisar sus entregas. Así tu sistema se entera de cada confirmación, cancelación o novedad sin que nadie copie datos.

Pasos en pantalla

1. Abre «Integraciones» → «API», pestaña «Webhooks», y pulsa «Agregar una URL».
2. Pega la URL segura, con https, donde tu sistema recibirá los avisos.
3. En los eventos elige «Todos los resultados de llamada (recomendado)», o elige solo los que necesitas.
4. Opcional: elige la tienda cuyos pedidos recibe y el ID del comercio en tu plataforma. Pulsa «Agregar webhook». Agregar una URL nunca reemplaza a otra.
5. En la fila de la URL usa «Enviar prueba» y «Ver secreto». Con ese secreto tu sistema verifica que cada aviso viene de Talkyria.
6. Revisa «Entregas recientes»: fecha, destino, evento y estado, «Exitoso» o «Fallido». Si falla, mira el código de respuesta de tu servidor.
7. Si solo te interesan algunos resultados, elige eventos sueltos: por ejemplo, solo confirmados y cancelados.
8. Puedes tener hasta 10 URLs por tienda, cada una con sus eventos. Agregar una nueva nunca reemplaza a otra.
9. Si una entrega falla, revisa que tu servidor responda con éxito: «Entregas recientes» muestra las últimas entregas con su código de respuesta.

Error común y cómo resolverlo

Agregar la misma URL dos veces. Talkyria no lo permite: edita la existente o actívala si estaba inactiva. Y si tu sistema rechaza los avisos, verifica que esté usando el secreto correcto de esa URL para comprobar la firma.

¿Y ahora qué?

Y si tus asesores trabajan dentro de tu propio sistema, también pueden llamar desde ahí. Siguiente lección: «¿Cómo pongo el teléfono de mis asesores dentro de mi propio sistema?».