Conexión del bot: deja que la IA consulte tu propio sistema

Qué hace

• Antes de la conversación: si tu sistema ofrece lookup_caller, Twilper reconoce a quien llama o visita.
• Durante la conversación: la IA llama a las herramientas de tu sistema (por ejemplo, búsqueda de productos, estado del pedido, opciones y precios). En el chat web, el visitante ve un breve mensaje de que se está consultando.
• La IA solo da detalles de un pedido tras recibir el número de pedido más el correo o el código postal.

Qué necesitas

• Un endpoint https en tu propio sistema, creado como se describe en twilper.com/integrations/api.
• Una clave de firma de al menos 32 caracteres (o deja que Twilper cree una).

Configurar

1. 1

   Paso 1: Abre la conexión del bot

   Ve a "Integraciones" y desplázate hasta "Conecta tu propio sistema (conexión del bot)".

   

2. 2

   Paso 2: Introduce el endpoint

   Escribe la dirección de tu sistema en el campo URL del endpoint, por ejemplo https://tusitio.com/api/twilper/channel.

3. 3

   Paso 3: Clave y activación

   Pega tu propia clave en el campo de la clave de firma o déjalo vacío para que se cree una. Marca la casilla de conexión activa y pulsa "Guardar".

Reglas y ajustes

• Cada petición va firmada con HMAC-SHA256. Tu sistema debe comprobar la firma y rechazar las peticiones sin una firma válida.
• Cada petición lleva un contexto con el canal, quien llama o visita y si la identidad está verificada. Devuelve solo datos que pertenezcan a esa persona.
• La IA usa las mismas herramientas en el chat web, WhatsApp y el teléfono.

Pruebas

• Usa "Probar la conexión" en la tarjeta: elige un canal (chat web, WhatsApp o teléfono), escribe un mensaje como "¿Dónde está mi pedido?" y pulsa "Enviar prueba". Verás la respuesta y qué herramientas puede usar la IA.
• Después haz la misma pregunta en el chat web real y revisa los registros de tu sistema.

Problemas frecuentes

• La IA responde por su cuenta en lugar de tu sistema: tu endpoint no respondió en 6 segundos (herramientas: 4 segundos) o devolvió un error. Twilper usa entonces la IA integrada.
• La firma no coincide: asegúrate de usar el cuerpo sin procesar (raw body) y la misma clave que en Twilper.