Integración con Vapi AI

Vapi AI — es un servicio para crear asistentes de voz con inteligencia artificial. Los asistentes de voz pueden realizar y recibir llamadas de forma autónoma o formar parte de un equipo de operadores. Hay una amplia variedad de voces para la síntesis de voz, así como opciones de personalización flexible, incluyendo la selección de la velocidad del habla, sonidos de fondo, uso de marcación adicional y mucho más.

1) En el área personal de Vapi AI entre en los ajustes de su organización, en el apartado API keys copie Private Key

Agregar en Vapi AI el usuario SIP, contraseña y dirección del servidor

Es necesario crear y enviar una solicitud curl con los siguientes datos:

• badcf222-9542-4d39-a834-fef874b7aec1 - Su Private Key desde el área personal de Vapi AI.
• Zadarma Trunk - Nombre de la troncal.
• sip.zadarma.com - Dirección del servidor para la conexión y envío de llamadas salientes
• 111111 - Su usuario SIP desde el área personal
• SipPassword - Su contraseña del usuario SIP, se puede generar aquí

curl -L 'https://api.vapi.ai/credential' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer badcf222-9542-4d39-a834-fef874b7aec1' \
-d '{
"provider": "byo-sip-trunk",
"name": "Zadarma Trunk",
"gateways": [
{ "ip": "sip.zadarma.com" }
],
"outboundLeadingPlusEnabled": true,
"outboundAuthenticationPlan": {
"authUsername": "111111",
"authPassword": "SipPassword"
}
}'

Si la solicitud está formulada correctamente, la respuesta contendrá los siguientes datos:

{"id":"7c97ecbe-7e1d-4fa1-8259-8ed32f8a9edd","orgId":"487ba655-4fb2-4a55-abfe-ddded2442631","provider":"byo-sip-trunk","createdAt":"2025-02-25T11:24:02.450Z","updatedAt":"2025-02-25T11:24:02.450Z","gateways":[{"ip":"sip.zadarma.com"}],"name":"Zadarma Trunk","outboundAuthenticationPlan":{"authUsername":"384540"},"outboundLeadingPlusEnabled":true}

2) Agregar el número virtual en Vapi AI

Para ello, es necesario crear y enviar una segunda solicitud curl con los siguientes datos:

• badcf222-9542-4d39-a834-fef874b7aec1 - Su Private Key desde el área personal Vapi AI.
• Zadarma Number - Nombre del número.
• 15551111111 - Su número virtual desde el área personal
• Zadarma Trunk - Nombre de la troncal.
• 7c97ecbe-7e1d-4fa1-8259-8ed32f8a9edd - ID de la respuesta a la primera solicitud.

curl -L 'https://api.vapi.ai/phone-number' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer badcf222-9542-4d39-a834-fef874b7aec1' \
-d '{
"provider": "byo-phone-number",
"name": "Zadarma Number",
"number": "15551111111",
"numberE164CheckEnabled": false,
"credentialId": "7c97ecbe-7e1d-4fa1-8259-8ed32f8a9edd"
}'

3) En el área personal de Vapi AI abra el apartado Build - Phone numbers, entre en su Zadarma Number y en el apartado Inbound Settings en el parámetro Assistant seleccione a su asistente de voz que recibirá las llamadas entrantes. Más abajo, en el apartado Outbound Form en el parámetro Assistant seleccione a su asistente de voz que realizará las llamadas salientes

4. Configuración de llamadas entrantes en Zadarma

Para recibir llamadas entrantes configure el desvío desde su número virtual de Zadarma a Vapi AI:

1. Entre en Zadarma en el apartado "Configuración" → "Números virtuales".
2. Haga clic en el icono de ajustes (⚙) junto a su número.
3. Abra la pestaña "Servidor externo".
4. Active la opción "Servidor externo (SIP URI)".
5. En la ventana emergente inserte la dirección de destino: 15551111111@sip.vapi.ai, donde 15551111111 es su número en formato internacional.
6. Haga clic en "Guardar".