Интеграция с Twilio без кода: SMS, WhatsApp и автоматические звонки

Интеграция с Twilio в nana800 - это один блок «Twilio»: он отправляет SMS и сообщения WhatsApp, звонит на телефон и читает текст голосом или выполняет ваш сценарий звонка. Нужны только Account SID и Auth Token вашего аккаунта Twilio, код не нужен. Запуск блока стоит 0,20 ₽, а за SMS, WhatsApp и звонки Twilio списывает деньги с вашего баланса в Twilio.

Собрать в конструкторе
  • Запуск блока: 0,20 ₽
  • Бесплатно каждый месяц: 350 ₽
  • Карта не нужна

Что можно сделать

  • Отправлять SMS со своего номера Twilio или от имени отправителя буквами в странах, где это разрешено
  • Писать клиентам в WhatsApp: обычным текстом в течение 24 часов после их сообщения или по утверждённому шаблону
  • Прикладывать до 10 картинок или файлов: в WhatsApp картинки, PDF, аудио и видео, в SMS как MMS (в основном номера США и Канады)
  • Звонить клиенту, чтобы робот прочитал текст женским или мужским голосом на одном из 12 языков, в том числе на русском
  • Запускать звонок по своему сценарию TwiML: проиграть запись или переключить на другой номер
  • Получать от Twilio отчёты о доставке сообщения и завершении звонка на свой адрес

Блоки в конструкторе

  • Twilio (SMS, WhatsApp, звонки)

    Действие · 0,20 ₽ за запуск

    Четыре действия: send_sms, send_whatsapp, make_call_with_text и make_call_with_twiml_url. Возвращает success, номер сообщения или звонка в Twilio (sid), его статус, а при отказе код и текст ошибки Twilio.

Как настроить

  1. 1

    Возьмите ключи в Twilio Console

    Войдите в Twilio Console и на главной странице найдите блок Account Info. Скопируйте Account SID (начинается с AC), затем нажмите Show и скопируйте Auth Token. Токен даёт доступ к деньгам на аккаунте, никому его не показывайте.

  2. 2

    Подготовьте номер-отправитель

    Для SMS и звонков нужен номер, купленный в вашем аккаунте Twilio, для звонка подойдёт и подтверждённый в Twilio номер. Чтобы проверить WhatsApp без покупки номера, откройте WhatsApp Sandbox: получатель один раз отправляет на номер песочницы кодовую фразу из Twilio.

  3. 3

    Добавьте блок «Twilio» в схему

    Создайте схему, поставьте триггер, например «webhook» для заявок с сайта или «button» для проверки, и добавьте блок «Twilio». Выберите действие, вставьте Account SID и Auth Token, заполните «Кому» в формате +79991234567 и «От кого».

  4. 4

    Напишите сообщение или текст звонка

    Для SMS и WhatsApp напишите текст до 1600 символов и подставьте данные из триггера. Для звонка напишите, что скажет робот (до 3000 символов), и выберите язык и голос. Для звонка по сценарию вставьте ссылку на TwiML, проще всего создать его в разделе TwiML Bins.

  5. 5

    Включите и проверьте схему

    Включите схему, нажмите кнопку и откройте результат блока: success равен true, если Twilio принял сообщение или звонок. Если нет, в error_message будет код и текст ошибки Twilio. Когда всё работает, оставьте схему включённой, она стоит 0,42 ₽ в час.

Частые вопросы

Запуск блока стоит 0,20 ₽ и списывается, только если Twilio принял запрос. За SMS, WhatsApp и звонки Twilio берёт деньги с вашего баланса в Twilio, длинное SMS оплачивается по частям. Включённая схема стоит 0,42 ₽ в час. Баланс nana800 каждый месяц бесплатно пополняется до 350 ₽. Если схема включена круглосуточно весь месяц, большая часть этой суммы уходит на часы её работы.

На пробном аккаунте писать и звонить можно только на номера, подтверждённые в Twilio Console (Verified Caller IDs), а в начало SMS добавляется надпись о пробном аккаунте. Ошибка 21608 как раз значит, что номер получателя не подтверждён. Ограничения снимаются после пополнения баланса Twilio.

Первым или позже чем через 24 часа после последнего сообщения человека WhatsApp разрешает писать только по утверждённому шаблону. Создайте шаблон в Twilio Console в разделе Content Template Builder, вставьте в блок его Content SID (начинается с HX) и укажите значения для мест шаблона по номерам 1, 2, 3. Без шаблона Twilio вернёт ошибку 63016.

Да. Выберите действие make_call_with_text, напишите текст, например «Ваш заказ готов, заберите его сегодня до 20:00», и язык ru-RU. По-русски робот говорит голосами Polly.Tatyana (женский) или Polly.Maxim (мужской). Код, который нужно произнести по одной цифре, пишите через пробел: 1 2 3 4.

Что Twilio принял сообщение или звонок в работу. Это ещё не доставка: статус queued значит, что сообщение стоит в очереди. Итог доставки Twilio пришлёт на адрес из поля «Ссылка для отчётов о статусе», если вы его заполнили.

20003 - неверный Account SID или Auth Token. 21211 - неверный номер получателя, проверьте плюс и код страны. 21606 - номер «От кого» не принадлежит аккаунту или не умеет отправлять сообщения. 21408 - отправка в эту страну выключена в Messaging, Settings, Geo permissions. 21610 - получатель ответил STOP и отписался.

Соберите первую схему бесплатно

Регистрация бесплатная, карта не нужна. Каждый месяц баланс бесплатно пополняется до 350 ₽, этого хватает примерно на 3 500 запусков простых блоков.

Собрать в конструкторе