Integraciones

Webhooks

Proporciona a tu recepcionista herramientas personalizadas que llamen a tus rutas de API HTTP.

Las integraciones de webhook exponen rutas de API HTTP personalizadas como herramientas que la recepcionista o el asistente empresarial pueden usar durante las conversaciones. A diferencia de los sistemas de notificaciones pasivos, la IA invoca activamente estas rutas de API cuando el contexto de la conversación lo requiere.

Cómo funcionan las herramientas de webhook

Al crear una integración de webhook, defines:

  1. Una ruta de API HTTP que puede usar tu recepcionista
  2. Una descripción de lo que hace (para que la IA sepa cuándo usarla)
  3. Los parámetros que la IA debe recopilar de la conversación

Durante una llamada, si la conversación coincide con el propósito de la herramienta, tu recepcionista llama a la ruta de API, procesa la respuesta y continúa la conversación.

Crear una herramienta de webhook

  1. Ve a Integraciones → haz clic en Webhook
  2. Haz clic en Añadir webhook
  3. Configura:
CampoDescripción
NombreNombre de la herramienta que la IA ve internamente
DescripciónCuándo y por qué usar esta herramienta (ayuda a decidir a la IA)
URLTu ruta de API HTTP
MétodoGET, POST, PUT, PATCH o DELETE
Parámetros del cuerpoParámetros enviados en el cuerpo de la solicitud
Parámetros de consultaParámetros enviados como cadenas de consulta de URL
Tiempo de espera de respuestaCuánto esperar a tu servidor (segundos)
Desactivar interrupcionesImpide que quien llama interrumpa mientras se ejecuta la herramienta
Agentes de destinoQué agentes pueden usar esta herramienta

Parámetros

Cada parámetro tiene:

  • Clave — El nombre del campo
  • Tipo — string, number o boolean
  • Descripción — Qué valor debe extraer la IA de la conversación
  • Obligatorio — Si la IA debe recopilarlo antes de llamar

Agentes de destino

Asigna cada herramienta de webhook a:

  • Recepcionista de cara al cliente — Disponible durante las llamadas telefónicas
  • Asistente empresarial — Disponible en el chat del panel
  • Ambos — Disponible en todas partes

Casos de uso

SituaciónDescripciónMétodo
Consulta de CRMBusca información del cliente en tu sistemaGET
Comprobación de inventarioComprueba la disponibilidad de productos en tiempo realGET
Captación de contactosEnvía los datos de quien llama a tu sistema de marketingPOST
Creación de ticketsCrea un ticket de soporte durante la llamadaPOST
PresupuestoCalcula un presupuesto personalizado según los requisitos de quien llamaPOST

Ejemplo

Una empresa de fontanería crea una herramienta de webhook:

  • Nombre: “Comprobar disponibilidad en la zona”
  • Descripción: “Comprueba si atendemos en el código postal de quien llama y cuál es la próxima cita disponible”
  • URL: https://api.mybusiness.com/check-area
  • Método: POST
  • Parámetros: zip_code (cadena, obligatorio), service_type (cadena, obligatorio)

Durante una llamada, cuando alguien pregunta por la disponibilidad en su zona, la recepcionista recopila su código postal, llama al webhook y le comunica el resultado.

Las integraciones de webhook requieren el plan Basic o superior.