Appearance
Подключение Zendesk
Платформа отправляет сообщения WhatsApp через Zendesk Sunshine Conversations (Conversations API).
Что нужно заранее
- Аккаунт Zendesk с продуктами для работы с мессенджерами (например, Zendesk Suite) и подключенным каналом WhatsApp.
- Шаблоны сообщений, одобренные в WhatsApp Business Manager.
Состав продуктов Zendesk меняется
Какие продукты нужны для WhatsApp, уточняйте на сайте Zendesk.
Как получить реквизиты
- Войдите в Zendesk и откройте Admin Center (значок шестеренки в боковом меню).
- Перейдите в Apps and integrations → APIs → Conversations API.
- Нажмите Create API key, введите название ключа и нажмите Next.
- Скопируйте App ID, Key ID и Secret Key.
Реквизиты показываются один раз
После закрытия окна Secret Key больше не покажется. Сохраните его в надежном месте.
Еще понадобится ID интеграции канала WhatsApp в Sunshine Conversations. Его можно посмотреть в настройках интеграции WhatsApp в Admin Center или запросить у поддержки Zendesk.
Добавление шлюза
- Откройте Коммуникации → Настройки → Шлюзы WhatsApp и нажмите Добавить шлюз.
- Выберите провайдера Zendesk.
- Заполните поля:
| Поле | Что вводить | Обязательно |
|---|---|---|
| Идентификатор приложения | App ID | Да |
| Логин | ID интеграции WhatsApp | Да |
| Key ID | Key ID ключа Conversations API | Да |
| Secret | Secret Key ключа Conversations API | Да |
- Нажмите Сохранить.
При изменении шлюза поле Secret можно оставить пустым: сохраненный ключ не изменится.
Настройка рассылки
- Шаблон провайдера — имя шаблона точно в том виде, в котором он одобрен в WhatsApp Business Manager.
- Пространство имен шаблона — namespace шаблонов вашего бизнес-аккаунта WhatsApp. Поле обязательно для Zendesk.
- Заголовок сообщения и Изображение — значения для заголовка шаблона, если он есть.
- Параметры шаблона — значения переменных тела шаблона по порядку.
- Кнопки должны совпадать с кнопками шаблона по типу и порядку.
Язык шаблона
Через Zendesk всегда отправляется русская версия шаблона (ru), без автоматического выбора языка. Шаблон должен быть одобрен на русском языке.
Коллбэки: статусы доставки
Платформа пока не принимает статусы от Zendesk. Вебхук в Zendesk настраивать не нужно. В отчетах будут отправки и клики, а доставка, прочтение и отказы учитываться не будут.
Отписаться клиент может только кнопкой со ссылкой.
Проверка
Отправьте тестовое сообщение из карточки рассылки. Если оно не пришло:
- Проверьте имя шаблона и namespace.
- Убедитесь, что шаблон одобрен на русском языке.
- Проверьте App ID, ID интеграции, Key ID и Secret в шлюзе.