Інтеграція з Vapi AI

Vapi AI — це сервіс для створення голосових асистентів за допомогою штучного інтелекту, голосові асистенти можуть самостійно приймати і здійснювати дзвінки або бути частиною команди операторів. Є велийкий асортимент голосів для синтезу мови та гнучке налаштування голосу, вибор швидкості мови, фонових звуків, використання донабору та багато інше.

1) В особистому кабінеті Vapi AI перейдіть в налаштування вашої організації, в розділі API keys скопіюйте Private Key

VAPI API keys

Додавання в Vapi AI sip-логіну, пароля та адреси серверу

Необхідно скласти і надіслати curl-запит з наступними данними:

  • badcf222-9542-4d39-a834-fef874b7aec1 - Ваш Private Key з особистого кабінету Vapi AI.
  • Zadarma Trunk - Ім'я транку.
  • sip.zadarma.com - Адреса серверу для підключення та надсилання вихідних дзвінків.
  • 111111 - Ваш sip-номер з личного кабинета.
  • SipPassword - Ваш пароль від sip-номеру, сгенерувати можна тут.

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"
}
}'

Якщо запит складено правильно, у відповіді на запит будуть наступні дані:


{"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) Додавання в Vapi AI віртуального номеру

Для цього необхідно скласти і надіслати другий curl-запит з наступними данними:

  • badcf222-9542-4d39-a834-fef874b7aec1 - Ваш Private Key з особистого кабінету Vapi AI.
  • Zadarma Number - Ім'я номеру.
  • 15551111111 - Ваш віртуальний номер з особистого кабінету.
  • Zadarma Trunk - Ім'я транку.
  • 7c97ecbe-7e1d-4fa1-8259-8ed32f8a9edd - id з відповіді на перший запит.

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) В особистому кабінеті Vapi AI відкрийте розділ Build - Phone numbers та перейдіть у ваш Zadarma Number та в секції Inbound Settings в параметр Assistant оберіть вашого голосового асистента, який буде приймати вхідні виклики. Нижче на сторінці в секції Outbound Form в параметрі Assistant оберіть вашого голосового асистента, який буде здійснювати вихідні дзвінки

VAPI - Inbound settings

4. Налаштування прийому вхідних дзвінків

Аби приймати вхідні дзвінки, налаштуйте переадресацію з вашого віртуального номеру Zadarma в Vapi AI:

  1. Перейдіть в Zadarma у розділ "Налаштування" → "Віртуальні номери".
  2. Навпроти вашого номеру натисніть ⚙ (шестірня).
  3. Відкрийте вкладку "Зовнішний сервер".
  4. Увімкніть опцію "Зовнішний сервер (SIP URI)".
  5. У вікні, що з'явилось, введіть адресу: 15551111111@sip.vapi.ai, де 15551111111 – це ваш віртуальний номер в міжнародному форматі.
  6. Натисніть "Зберегти".