WhatsApp Inbox API: Инбокс команды в ваших системах

У Инбокса появился свой API. Диалоги в Shared Inbox теперь доступны из кода: их можно получить и найти, назначить ответственного, открыть и закрыть, заблокировать контакт и получать события на вебхук. Команда работает в Инбоксе как раньше и сразу видит, что изменил код.

Если вы уже на WhatsApp Business API, там всё по-прежнему: отправка, шаблоны, входящие и статусы доставки.

WhatsApp Team Inbox API

WhatsApp Inbox API — это HTTP API к Инбоксу 1MSG: диалоги, ответственные, статусы, история и события команды. Код действует в Инбоксе как оператор на платформе, и команда видит результат сразу. В чате остаётся системное сообщение. События приходят на вебхук, и каждое подписано.

Зачем это нужно:

• Инбокс прямо в CRM. Очередь и история диалога видны в карточке клиента, а сам диалог находится по телефону или по тексту сообщения.
• Распределение по вашим правилам. Новый диалог сразу попадает к нужному оператору: по языку, региону или типу клиента.
• От бота к человеку. Когда без оператора не обойтись, бот передаёт ему диалог. Когда вопрос закрыт, диалог тоже закрывается.
• CRM без ручной сверки. По событиям Инбокса обновляются ответственный и статус сделки или обращения.
• Очередь на виду. По счётчикам можно собрать панель или включить оповещение, если диалоги без ответственного копятся.

Представляем 1MSG Platform API

Раньше API 1MSG был про WhatsApp: сам WhatsApp Business API и наши методы к нему.

WhatsApp Inbox API — первый API новой платформы 1MSG, и он не про канал WhatsApp. Он про работу команды с диалогами. У него свои ключи, своя документация и свой вебхук.

Задачи у двух API разные. WhatsApp Business API отправляет и принимает сообщения. Inbox API отвечает за то, кто ведёт диалог, в каком он статусе и что изменилось. Ответ клиенту по-прежнему уходит через WhatsApp Business API, а входящие и статусы доставки приходят на вебхук канала.

Инбокс — первый.

С чего начать

WhatsApp Inbox API работает на новой платформе 1MSG. Ключ выписан на пользователя и берёт его права: те же каналы, действия от его имени. Нужны все каналы — владелец создаёт ключ для себя. Код должен видеть только то, что видит коллега, — создайте ключ для него.

Ключ передаётся как Bearer-токен. События Инбокса приходят на URL, который задаёт владелец аккаунта. Методы и события описаны в документации WhatsApp Inbox API.