Saltar a la navegación
Integraciones

Webhooks

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

La integración de la herramienta de webhook expone tus rutas de API HTTP como herramientas que tu recepcionista o asistente de negocio puede usar 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

Al crear 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. Parámetros que la IA debe recopilar de la conversación.

Durante una llamada, cuando la conversación coincide con la finalidad 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 tiempo esperar a tu servidor: de 5 a 120 segundos; el valor predeterminado es 20
Asignar a agentesRecepcionista, Agente asistente o ambos
Desactivar interrupcionesImpide que quien llama interrumpa mientras se ejecuta la herramienta
Encabezados de solicitudEncabezados opcionales que se envían con cada solicitud. El Tipo es Valor o Secreto. Un Secreto se almacena cifrado y no vuelve a mostrarse. Un encabezado procedente de ElevenAgents puede mostrar Variable de entorno o Variable, con una nota de que se configura en la plataforma de agentes.
Parámetros de rutaSe muestran cuando la URL contiene marcadores de posición entre llaves, como /orders/{order_id}. Edita la URL para añadir o eliminar uno.
Parámetros del cuerpoParámetros enviados en el cuerpo de la solicitud. El Valor puede ser De la conversación o un Valor fijo.
Parámetros de consultaParámetros enviados como cadenas de consulta de la URL. El Valor puede ser De la conversación o un Valor fijo.

Parámetros

Cada parámetro incluye:

  • 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.

Casos de uso

EscenarioDescripciónMétodo
Consulta de CRMConsulta la información del cliente en tu sistemaGET
Consulta 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 atendemos el código postal de quien llama y cuál es el siguiente horario disponible.”
  • URL: https://api.mybusiness.com/check-area
  • Método: POST
  • Encabezados de solicitud: Authorization configurado con la clave de API de la empresa
  • Parámetros del cuerpo: zip_code (string, obligatorio), service_type (string, obligatorio)

Cuando alguien llama para preguntar por el servicio en su zona, el 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.