Перейти к содержимому
OmniChannels.ai
Меню

Продуктивность и операции

Airtable + OmniChannels.ai: отправка сообщений при изменении записей

Подключение через API и вебхукиОбновлено

Коротко

Airtable подключается к OmniChannels.ai через собственные автоматизации, а не через расширение из маркетплейса. Действие Run a script с помощью fetch вызывает наш REST API с вашим Bearer-токеном и отправляет WhatsApp или SMS при изменении записи. Триггер When webhook received может записывать статусы доставки обратно в базу. Make, Zapier или n8n решают ту же задачу без скриптов.

Что вы можете делать

  • Отправка шаблона WhatsApp при добавлении новой строки

    Когда в таблице создаётся запись, отправьте утверждённый шаблон WhatsApp со значениями её полей контактам, которые дали согласие на получение сообщений (opt-in).

  • Подтверждение бронирования при смене статуса

    Когда статус записи меняется на Confirmed, отправьте подтверждение по SMS или в WhatsApp на номер из этой записи.

  • Оповещение команды о неудачной доставке

    Статусы доставки обновляют соответствующую запись; вторая автоматизация уведомляет владельца записи, если статус FAILED или REJECTED, вместо повторной отправки.

  • Журнал сообщений в базе

    Записывайте в запись каждый полученный ID сообщения, а затем обновляйте её статус по мере поступления событий SENT, DELIVERED и READ.

  • Отправка без скриптов

    Используйте сценарий Make, Zapier или n8n, который отслеживает базу и вызывает API, если вы не хотите поддерживать скрипт.

Как устроено подключение

Подключение через API и вебхуки

Добавьте в автоматизацию Airtable действие Run a script, передайте поля записи как входные переменные и с помощью fetch отправьте POST-запрос на путь отправки нужного канала на https://api.broadnet.me с заголовком Authorization, содержащим Bearer и ваш токен. Для одиночной SMS используется тело в формате JSON, что удобно для скрипта; массовые рассылки и отправка в большинстве других каналов принимают multipart form data, и их проще настроить через инструмент автоматизации или собственный код. Скрипт может прочитать любой, кто вправе редактировать автоматизацию, поэтому ограничьте доступ на редактирование или храните токен в хранилище учётных данных инструмента автоматизации.

Чтобы получать статусы, добавьте триггер When webhook received, передайте его URL нашей команде или администратору вашего аккаунта для настройки в качестве webhook на аккаунте и обновляйте соответствующую запись по ID сообщения. Скриптовые действия и webhook-триггеры доступны только на некоторых тарифах Airtable, а у webhook-триггеров есть собственные ограничения по частоте запросов; уточните актуальные условия тарифов в Airtable.

  • Отправка: действие Run a script с fetch на https://api.broadnet.me
  • Аутентификация: Authorization: Bearer <token> в запросе
  • Приём статусов: URL триггера When webhook received, настроенный на вашем аккаунте
  • Вариант без кода: Make, Zapier или n8n между Airtable и API
  • Никогда не отправляйте сообщение повторно автоматически из автоматизации по статусам

Настройка

  1. 1

    Запросите доступ к API

    Запросите тестовый доступ и получите API-токен. Тестовые отправки идут только на ваши собственные верифицированные номера.

    Руководство: Quickstart: send your first message
  2. 2

    Создайте триггер автоматизации

    Добавьте автоматизацию, которая запускается при создании записи или при выполнении условий, например когда в поле статуса указано Confirmed.

  3. 3

    Добавьте действие Run a script

    Передайте поля с номером телефона и текстом сообщения как входные переменные и отправьте их POST-запросом через fetch на URL отправки нужного канала с заголовком Authorization.

    Руководство: SMS API
  4. 4

    Сохраните ID сообщения

    Запишите полученный ID сообщения обратно в запись, чтобы позже сопоставлять с ней события статусов.

  5. 5

    Получайте статусы доставки

    Создайте вторую автоматизацию с триггером When webhook received, передайте её URL нашей команде или администратору вашего аккаунта, затем проверьте работу на своём номере.

    Руководство: Webhooks and delivery statuses

Документация вендора

Airtable является товарным знаком своего владельца. OmniChannels.ai не связана с Airtable и не одобрена компанией Airtable; на этой странице описано подключение, которое строится на собственных функциях MCP, HTTP или вебхуков Airtable.

Пример сценария

Как типичный запрос проходит от Airtable к вашему клиенту и обратно.

  1. 01

    Запись в Airtable

    Новая запись или изменённое поле статуса

  2. 02

    Действие Run a script

    POST-запрос fetch к REST API с вашим Bearer-токеном

  3. 03

    API OmniChannels.ai

    Отправляет сообщение и возвращает ID сообщения

  4. 04

    Телефон клиента

    Сообщение в WhatsApp или SMS доставлено

  5. 05

    When webhook received

    Статусы доставки обновляют соответствующую запись

1. Запись в Airtable: Новая запись или изменённое поле статуса 2. Действие Run a script: POST-запрос fetch к REST API с вашим Bearer-токеном 3. API OmniChannels.ai: Отправляет сообщение и возвращает ID сообщения 4. Телефон клиента: Сообщение в WhatsApp или SMS доставлено 5. When webhook received: Статусы доставки обновляют соответствующую запись

Вопросы и ответы

Есть ли расширение OmniChannels.ai для Airtable?

Нет. Airtable подключается через собственные автоматизации: действие Run a script, которое вызывает наш REST API, и webhook-триггер, принимающий статусы. Вместо этого можно использовать промежуточный инструмент автоматизации, например Make, Zapier или n8n.

Какой тариф Airtable мне нужен?

Действия Run a script и webhook-триггеры доступны только на некоторых тарифах Airtable. Перед созданием автоматизации уточните актуальные условия тарифов в Airtable.

Можно ли отправлять шаблоны WhatsApp из Airtable?

Да, если скрипт или инструмент автоматизации вызывает операцию отправки в WhatsApp из нашей API-документации. Сообщения по инициативе компании вне 24-часового сервисного окна требуют утверждённого шаблона и получателя, давшего согласие на получение сообщений (opt-in).

Безопасно ли хранить API-токен в скрипте Airtable?

Токен находится в скрипте, который может прочитать любой, кто вправе редактировать автоматизации базы. Ограничьте доступ на редактирование, используйте тестовые учётные данные при разработке или храните токен в хранилище учётных данных инструмента автоматизации.

Получите доступ к API и MCP

Расскажите нам о ваших каналах, странах и сценарии использования. Инженер выдаст тестовые учётные данные и проверит ваши тестовые номера.