Saltar a la navegación
Integraciones

Webhooks

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

La integración Herramienta de webhook expone tus rutas de API HTTP como herramientas que tu recepcionista o asistente de negocio puede llamar durante las conversaciones. La IA decide cuándo llamar a la ruta de API según la conversación.

Cómo funcionan las herramientas de webhook

Cuando creas una herramienta de webhook, defines:

  1. Una ruta de API HTTP a la que llamar.
  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, cuando la conversación coincide con el propósito de la herramienta, tu recepcionista recopila los parámetros, llama a la ruta de API y usa la respuesta para continuar la conversación.

Crear una herramienta de webhook

Ve a Integraciones, selecciona Añadir integración y elige Herramienta de webhook. Configura los campos siguientes y selecciona Activar. Puedes añadir varias herramientas de webhook.

CampoDescripción
NombreNombre de la herramienta que ve la IA, por ejemplo check_order_status
DescripciónCuándo y por qué usar esta herramienta
MétodoGET, POST, PUT, PATCH o DELETE
URLTu ruta de API HTTP
Tiempo de espera de respuesta (segundos)Cuánto esperar a tu servidor: de 5 a 120 segundos, 20 de forma predeterminada
Asignar a agentesRecepcionista, Agente asistente o ambos
Desactivar interrupcionesImpide que quien llama interrumpa mientras se ejecuta la herramienta
Cabeceras de solicitudCabeceras opcionales enviadas con cada solicitud, como una clave de API
Parámetros del cuerpoParámetros enviados en el cuerpo de la solicitud
Parámetros de consultaParámetros enviados como cadenas de consulta de URL

Parámetros

Cada parámetro tiene:

  • Clave: el nombre del campo.
  • Tipo: string, number o boolean.
  • Descripción: el valor que la IA debe extraer de la conversación.
  • Obligatorio: si la IA debe recopilarlo antes de llamar.

Casos de uso

EscenarioDescripciónMétodo
Consulta de CRMConsulta información de clientes 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 asistencia 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: check_service_area
  • Descripción: “Comprueba si ofrecemos servicio en el código postal de quien llama y cuál es la siguiente franja disponible.”
  • URL: https://api.mybusiness.com/check-area
  • Método: POST
  • Cabeceras de solicitud: Authorization configurada con la clave de API de la empresa
  • Parámetros del cuerpo: zip_code (string, obligatorio), service_type (string, obligatorio)

Cuando alguien llama para consultar el servicio en su zona, la recepcionista recopila su código postal, llama al webhook y le comunica el resultado.

Las herramientas de webhook están disponibles en todos los planes.