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

CRM

Salesforce + OmniChannels.ai: сообщения клиентам из Flow и Apex

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

Коротко

Salesforce может отправлять WhatsApp и SMS через REST API OmniChannels.ai с помощью Flow HTTP Callout или вызова Apex. Bearer-токен при этом хранится в Named Credential и External Credential. Статусы доставки и ответы клиентов приходят через наш вебхук в промежуточный сервис (middleware) или инструмент автоматизации, который обновляет записи Salesforce. Пакета в AppExchange нет: вы используете собственные возможности Salesforce для вызова внешних сервисов.

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

  • Обработка новых лидов

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

  • Напоминания клиентам о встречах

    Запланированный путь (scheduled path) для события, сервисной встречи или пользовательского объекта отправляет напоминание перед визитом.

  • Сообщения при смене этапа сделки

    Когда сделка переходит на этап, например «закрыта успешно», основной контакт получает приветственное сообщение или сообщение для онбординга.

  • Напоминания о продлении

    Запланированный flow находит контракты или активы, у которых приближается дата продления, и отправляет утверждённый шаблон WhatsApp.

  • Запись статусов и ответов в карточку

    Middleware получает статусы и входящие ответы от нашего вебхука и создаёт задачу или обновляет поле в связанной записи.

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

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

Для исходящих сообщений Salesforce обращается к нашему API напрямую. Создайте External Credential, который добавляет заголовок Authorization: Bearer, и Named Credential для https://api.broadnet.me, а затем используйте действие Flow HTTP Callout или вызов Apex. HTTP Callout во Flow подходит для JSON-запросов, например POST /sms/sendSms. Массовые отправки и большинство отправок по другим каналам используют multipart/form-data, поэтому обычно нужны Apex или промежуточный инструмент автоматизации.

Обратный путь устроен так: наша платформа отправляет статусы доставки и входящие сообщения на единственный URL вебхука, настроенный для вашего аккаунта. Укажите в нём middleware под вашим контролем или инструмент автоматизации, например n8n, Make или Zapier. Он сопоставит сообщение по сохранённому ID и обновит Salesforce через REST API или коннектор.

  • Учётные данные: Named Credential и External Credential с Bearer-токеном
  • Flow HTTP Callout для JSON-запросов; Apex для multipart и сложной логики
  • Сохраняйте возвращённый ID сообщения в записи, чтобы потом сопоставлять статусы
  • Утверждённые шаблоны WhatsApp для сообщений по инициативе компании вне 24-часового окна
  • Вызовы учитываются в лимитах Salesforce; массовые отправки выполняйте из пакетного задания (batch job), а не по одной записи

Настройка

  1. 1

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

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

    Руководство: Authentication
  2. 2

    Создайте учётные данные

    В Setup создайте External Credential с пользовательским заголовком Authorization: Bearer <token> и Named Credential для https://api.broadnet.me, затем предоставьте доступ через набор разрешений (permission set).

  3. 3

    Добавьте вызов API

    В Flow Builder создайте действие HTTP Callout для POST /sms/sendSms с использованием Named Credential либо напишите класс Apex для отправки по другим каналам через multipart.

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

    Запустите его из flow

    Вызовите действие из flow, запускаемого записью, или из запланированного flow и сохраните возвращённый ID сообщения в записи.

  5. 5

    Настройте возврат статусов

    Попросите нашу команду указать вебхук вашего аккаунта на middleware или инструмент автоматизации, который обновит соответствующую запись Salesforce.

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

    Проверьте в песочнице

    Запустите flow в песочнице (sandbox) на тестовой записи с вашим подтверждённым номером, затем проверьте статус в записи.

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

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

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

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

  1. 01

    Salesforce Flow или Apex

    Лид создан, этап изменён или наступила дата продления

  2. 02

    API OmniChannels.ai

    HTTP-вызов через Named Credential

  3. 03

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

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

  4. 04

    Вебхук статуса доставки

    Отправляется в ваш middleware или инструмент автоматизации

  5. 05

    Обновление Salesforce

    Статус или ответ записан в связанную запись

1. Salesforce Flow или Apex: Лид создан, этап изменён или наступила дата продления 2. API OmniChannels.ai: HTTP-вызов через Named Credential 3. Телефон клиента: SMS или шаблон WhatsApp доставлен 4. Вебхук статуса доставки: Отправляется в ваш middleware или инструмент автоматизации 5. Обновление Salesforce: Статус или ответ записан в связанную запись

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

Есть ли пакет OmniChannels.ai в AppExchange?

Нет. Salesforce обращается к нашему публичному REST API с помощью собственных средств HTTP-вызовов — Flow HTTP Callout или Apex — через Named Credential, в котором хранится ваш токен.

Может ли Flow отправлять сообщения по всем каналам без кода?

Flow HTTP Callout хорошо подходит для JSON-запросов, например для одной SMS. Массовые отправки и большинство отправок по другим каналам используют multipart/form-data, поэтому обычно нужны вызов Apex или промежуточный инструмент автоматизации.

Может ли наш вебхук отправлять данные прямо в Salesforce?

В удобном для работы виде — нет: поля в payload различаются по каналам, и их нужно сопоставлять с вашими записями. Отправляйте данные в middleware или инструмент автоматизации, который сопоставит поля и вызовет API Salesforce.

Где хранить API-токен?

В External Credential, на который ссылается Named Credential, и никогда в переменных flow или коде Apex. Так токен хранится в зашифрованном виде, а доступ контролируется через наборы разрешений.

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

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