respond-io
New
🚀 TikTok Business Messaging живый! Беспрепятственно превращать разговоры в конверсии. Узнайте больше.arrow-icon

Главная >

Каналы >
WhatsApp >
API облака WhatsApp

API облака WhatsApp

Avatar
JQ Lee
· 23 Jul 2024
2 мин чтения

Теперь вы можете перенести свою подключенную учетную запись WhatsApp 360dialog в API WhatsApp Business response.io, чтобы повысить надежность, снизить затраты и получить доступ к новым функциям. Подробнее о процессе миграции можно узнать здесь.

Для подключения WhatsApp Cloud API требуется приложение Facebook с включенным WhatsApp Product. Прочитайте это руководство о том, как настроить приложение Facebook.

Facebook объявила о выпуске WhatsApp Cloud API 20 мая. Теперь любой бизнес, независимо от размера, большой или малый, может общаться с клиентами, используя официальный WhatsApp API.

Из-за правил WhatsApp в этом канале имеется ограничение на 24 часа. Узнайте больше о деловой политике WhatsApp' здесь.

Подключение API WhatsApp Cloud

Посмотрите видео ниже с пошаговым руководством по подключению WhatsApp Cloud API к response.io.

Чтобы общаться с клиентами через WhatsApp Cloud API, подключите профиль WhatsApp Business и учетную запись Meta Business.

Для подключения требуются приложение Facebook и учетная запись Meta Business, и вы должны быть администратором обоих.

Шаг 1:Перейдите вНастройки рабочего пространства> НажмитеДобавить канал

Шаг 2:Найдите канал API WhatsApp Cloud > НажмитеПодключиться.

Шаг 3: Нажмите кнопкуПодключиться к Facebook.

Шаг 4: Войдите в систему, используя учетную запись Facebook с правами администратора к приложению Facebook и бизнес-аккаунту Meta.

Шаг 5: В раскрывающемся списке выберите имя WABA с номером WhatsApp, который вы хотите подключить.

Шаг 6: Добавьте URL обратного вызова. Вернитесь в разделWhatsAppв приложении Facebook Developer. Перейдите в подразделКонфигурацияи настройте URL обратного вызова. Добавьте сгенерированный URL-адрес обратного вызова и проверьте токен из response.io в соответствующие поля в диалоговом окне веб-перехватчика.

Шаг 7: В приложении Facebook проверьте и сохраните изменения в приложении.

Шаг 8: Подпишитесь на событие вебхука. В приложении Facebook выберите вкладкуWebhooksна панелиProductsи выберитеWhatsApp Business Accountв раскрывающемся списке. Нажмите на событие «Подписаться на сообщения».

Шаг 9: Нажмите переключатель в верхней части страницы, чтобы включить режим реального времени.

Не забудьте указать URL-адрес вашей политики конфиденциальности. Если это поле пустое, вы не сможете включить режим реального времени.

Шаг 10: Нажмите «Сохранить изменения», чтобы завершить настройку.

После того, как вы'завершите настройку, все сообщения, отправленные на ваш номер WhatsApp, будут поступать в ваше рабочее пространство.

Конфигурация канала

Канал API WhatsApp Cloud можно настроить, присвоив ему уникальное имя.

Шаг 1:Перейдите вНастройки рабочего пространства> НажмитеКаналы.

Шаг 2:Найдите канал API WhatsApp Cloud > НажмитеУправление.

Шаг 3:Настройте имя канала, которое будет использоваться внутри для идентификации учетной записи.

Шаг 4:НажмитеСохранить изменения , чтобы обновить конфигурацию канала.

Метаданные, полученные каналом

Различные каналы предоставляют различные наборы метаданных Contact для платформы response.io. Список данных контакта, которые вы сможете получить по этому каналу:

  • Номер телефона

  • Номер телефона ID

  • Имя профиля

  • WhatsApp ID

Управление профилем API WhatsApp Cloud

Если вам необходимо внести изменения или проверить свой профиль WhatsApp Cloud API, это можно сделать на платформе response.io.

Шаг 1:Перейдите вНастройки рабочего пространства> НажмитеКаналы.

Шаг 2:Найдите канал API WhatsApp Cloud > НажмитеУправление > Профиль.

Шаг 3: Нажмите «Синхронизировать профиль», чтобы получить последнюю информацию о профиле WhatsApp Business из WhatsApp.

Шаг 4: При необходимости отредактируйте следующую информацию.

Поля

Описание

Фото профиля

Изображение, отображаемое в качестве изображения профиля бизнес-аккаунта WhatsApp. Рекомендуемый размер изображения — 640x640.

О программе

Бизнес's О тексте. Этот текст отображается в профиле компании'под ее изображением профиля, номером телефона и кнопками контактов.

Адрес

Адрес бизнеса. Максимум 256 символов.

Описание

Описание предприятия. Максимум 512 символов.

Почта

Адрес электронной почты (в действующем формате) для связи с бизнесом. Максимум 128 символов.

Вертикальный

Промышленность бизнеса. Должно быть одним из этих допустимых значений: Автомобильная красота, Спа и SalonClothing и ApparelEducationEntertainmentEvent Планирование и ServiceFinance и Банковская еда и GroceryPublic ServiceHotel и LodgingMedical и здоровье, некоммерческие профессиональные услуги Покупка и RetailTravel и Транспорт Ресторан.Другое бизнес вертикаль не может быть возвращен к чистой ценности после создания.

Сайт

URL-адреса (включая http:// или https://), связанные с бизнесом (например, сайт, страница Facebook, Instagram). Максимум 2 веб-сайтов с максимум по 256 символов каждый.

Шаг 5: Проверьте информацию и нажмите «Сохранить изменения».

Управление шаблонами сообщений WhatsApp

Перед отправкой шаблона сообщения контакту на платформе response.io убедитесь, что вы'выполнили следующее:

- Отправил шаблон сообщения на утверждение. - Добавил утвержденный шаблон сообщения в рабочее пространство, синхронизировав шаблон сообщения.

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

Шаг 1:Перейдите вНастройки рабочего пространства> НажмитеКаналы.

Шаг 2:Найдите канал API WhatsApp Cloud > НажмитеУправление.

Шаг 3: Нажмите «Шаблоны» > «Отправить шаблон» , чтобы отправить шаблон сообщения на утверждение.

Шаг 4: Заполните необходимую информацию для создания шаблона.

Поле

Описание

Название шаблона

Имя может содержать только строчные буквы, цифры и символы подчеркивания (_).

Категория

Категория, к которой принадлежит шаблон сообщения.

Язык

Язык, на котором написан шаблон.

Шаг 5: Создайте сообщение, заполнив необходимые компоненты, затем просмотрите сообщение в разделе предварительного просмотра. Вы можете включить параметры 1, 2и т. д. в качестве заполнителей для заполнения персонализированным содержимым.

Строительный блок

Описание

Тело

Тело содержит самый важный текст вашего шаблона. Поддерживается только текст. Вы можете использовать markdown для форматирования содержимого этого блока. Узнайте больше здесь.

Заголовок

Заголовок необязательный и служит в качестве заголовка или заголовка вашего шаблона. Поддерживается следующее:
- Текст
- Изображение
- Видео
- Документ

* Платформа Respond.io принимает загрузки размером до 20 МБ.

Колонтитул

Нижний колонтитул необязателен и поддерживает только текст. Его можно использовать для предоставления дополнительной информации в шаблоне сообщения.

Кнопка

Кнопка необязательна и добавляет интерактивности вашим шаблонам. Доступно два типа:
Кнопка призыва к действию
- Используется для отправки клиента на веб-сайт или звонка по номеру телефона
- Максимум один URL и номер телефона на шаблон
- URL может иметь параметр или персонализациюБыстрый

Кнопка ответа
- Используется для получения быстрых ответов от клиента
- Максимум 3 кнопки быстрого ответа на шаблон
- Каждая кнопка быстрого ответа не может содержать более 20 символов

* Быстрый ответ Кнопки поддерживаются только на платформах iOS, Android и веб-платформах, но не на платформе Windows. Здесь вы найдете более подробную информацию.

Шаг 6: Предоставьте пример значения

Это применимо только в том случае, если вы включили какие-либо параметры в содержимое шаблона сообщения.

Предоставление примеров значений для параметра в шаблоне сообщения поможет проверяющему WhatsApp понять сообщение, которое вы пытаетесь отправить своим контактам.

Важная ссылка: Руководство по шаблону сообщения WhatsApp

Синхронизация шаблонов сообщений

Шаг 1:Перейдите вНастройки рабочего пространства> НажмитеКаналы.

Шаг 2:Найдите канал WhatsApp Business Platform (API) > НажмитеУправление.

Шаг 3: Нажмите Шаблоны > Синхронизировать шаблон , чтобы начать процесс синхронизации.

Процесс синхронизации завершен. Это означает:

- Шаблоны сообщений будут перечислены с соответствующими им статусами. - Дата и время последней синхронизации будут обновлены. - Если ваш шаблон отклонен, причина отклонения будет отображена под отклоненным шаблоном сообщения.

В следующей таблице перечислены возможные статусы для шаблонов сообщений:

Статус

Описание

Отправлено

Шаблон сообщения отправлен и ожидает утверждения.

Одобрено

Шаблон сообщения одобрен и может быть отправлен контактам.

Отклонено

Шаблон сообщения отклонен и не может быть использован.

Используйте поиск и фильтр в правом верхнем углу объявления, чтобы легко найти ваши шаблоны!

Поддерживаемые типы файлов

WhatsApp поддерживает следующие типы файлов и максимальный размер файла для этого типа:

  • Аудио & Видео (16 МБ)

  • Документ (100 МБ)

  • Изображение (5 МБ)

  • Наклейка (100 КБ)

Не поддерживаемые сообщения будут иметь резервный дисплей с неподдерживаемым сообщением или пользовательским текстом и типом данных (если доступно). Для любого неподдерживаемого типа файла или файла, размер которого превышает максимальный размер файла, отправляемого через API WhatsApp Cloud, файл будет автоматически преобразован в URL-ссылку на платформе response.io. Для пользовательской полезной нагрузки вы можете нажать Показать больше, чтобы просмотреть полезную нагрузку JSON этого сообщения. Примеры неподдерживаемых сообщений для WhatsApp Cloud API:
- Карточка контакта
- Реакции
- Удаленное сообщение
- Опросы
- Эфемерное сообщение

Лимиты тарифа

Ограничение - это количество вызовов API приложением или пользователем в течение определенного периода времени, определенного каналом. Подробнее об ограничениях скорости для этого канала можно узнать здесь.

FAQ и устранение неполадок

Невозможно отправить сообщения

Убедитесь, что номер, который вы'подключили к платформе, является номером API WhatsApp Cloud.

Сообщения не приходят

Это может произойти, если веб-хук сообщений не подписан.

Шаг 1: Перейдите на страницу Facebook App Webhook.

Откройте приложение Facebook и перейдите на страницу Webhooks .

Шаг 2: Проверьте подписанное событие

Выберите учетную запись WhatsApp Business и проверьте, подписаны ли вы на событие сообщения .

Шаг 3: Отправьте тестовое сообщение

Отправьте тестовое сообщение на номер телефона WhatsApp и проверьте, дошло ли оно.

Невозможно получить уведомления о прочтении

Когда пользователь, подключенный к WhatsApp Cloud API, меняет свой пароль Facebook, разрешения устаревают и их необходимо обновить.

Шаг 1:Перейдите вНастройки рабочего пространства> НажмитеКаналы.

Шаг 2:Найдите канал WhatsApp Business Platform (API) > НажмитеУправление.

Шаг 3: Нажмите «Устранение неполадок» >Обновить разрешения, чтобы обновить разрешения WhatsApp.

Шаг 4: Отправьте тестовое сообщение на номер телефона WhatsApp и проверьте, дошло ли оно.

Невозможно отправить исходящие сообщения: ошибка проверки токена доступа

Это может произойти по нескольким причинам:

  • Когда сеанс проверки токена доступа истек.

  • В Meta Business Manager были изменены права администратора пользователя'.

  • Произошла смена пароля в Meta Business Manager.

Чтобы устранить эту ошибку, необходимо обновить разрешения канала API WhatsApp Cloud и снова отправить тестовое сообщение.

Чтобы иметь возможность обновить разрешения, вы должны быть администратором Meta Business Manager.

Контакт не получает сообщения

Это может произойти, если Контакт не согласился с условиями и политикой конфиденциальности WhatsApp.

Если ваши контакты не могут получать сообщения с вашего номера API WhatsApp Cloud, убедитесь, что они согласились с последними условиями и политикой конфиденциальности WhatsApp.

Каковы требования к номеру телефона, который будет использоваться для регистрации в WhatsApp Cloud API?

  • Номер телефона, используемый для API WhatsApp Cloud,'нельзя использовать в личном или деловом приложении WhatsApp. Вам'придется удалить учетную запись в личном или деловом приложении WhatsApp, прежде чем вы сможете использовать номер для регистрации в API WhatsApp Cloud.

  • Вы по-прежнему сможете использовать номер для других целей, например, для звонков и получения SMS, после его регистрации на платформе WhatsApp Business.

  • После использования телефона для API WhatsApp Cloud вы больше не сможете использовать этот номер в приложении WhatsApp Business.

Нужна ли проверка бизнеса для начала использования Cloud API?

Чтобы начать отправлять сообщения в WhatsApp, не обязательно проходить проверку Facebook Business. Без подтверждения личности ваш бизнес все равно сможет:

  • Отвечайте на неограниченное количество разговоров, инициированных пользователями.

  • Отправляйте бизнес-инициированные беседы (шаблоны сообщений) 250 уникальным клиентам в течение 24 часов.

  • Зарегистрируйте до 2 номеров телефона.

Предприятия могут инициировать проверку бизнеса только тогда, когда они'готовы масштабировать деловые разговоры или хотят стать официальным бизнес-аккаунтом.

Могу ли я просмотреть аналитику своих разговоров в аккаунте WhatsApp Business?

Да, вы можете отслеживать аналитику сообщений и расходов в режиме реального времени для своего бизнес-аккаунта WhatsApp на вкладке Аналитика вашего Meta WhatsApp Manager. Подробнее читайте здесь.

Каковы лимиты на сообщения WhatsApp?

Лимиты на отправку сообщений определяют максимальное количество деловых разговоров, которые можно осуществить с каждого телефонного номера в течение 24-часового периода. Эти ограничения не распространяются на разговоры, инициированные пользователем. Деловой разговор начинается с момента доставки первого сообщения клиенту и заканчивается через 24 часа. Подробнее читайте здесь.

Как добавить способ оплаты в мой аккаунт WhatsApp Business?

Вы можете добавить способ оплаты в свою учетную запись WhatsApp Business в Business Manager. Узнайте, как добавить способ оплаты в свой аккаунт WhatsApp Business здесь.

Почему мое сообщение не удалось отправить из-за ошибки "Проблема с платежом для подтверждения права на участие в бизнесе"?

Вероятнее всего, это связано с тем, что вы превысили ежемесячный порог бесплатного уровня, не указав допустимый способ оплаты. Чтобы решить эту проблему, добавьте действительный способ оплаты.

Каковы цены на WhatsApp Cloud API?

API WhatsApp использует модель ценообразования на основе разговоров, при которой компании взимают плату за количество разговоров. Разговор начинается с момента, когда ваше деловое сообщение' доставляется клиенту, и длится в течение 24-часового окна обслуживания клиентов , в течение которого клиент и компания могут обмениваться любым количеством сообщений. Компании взимают плату за каждый отдельный разговор, независимо от того, сколько сообщений было отправлено или получено в течение данного окна обслуживания клиентов.

Узнайте больше о ценах WhatsApp здесь.

Как удалить номер телефона из бизнес-аккаунта?

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

Могу ли я использовать response.io для отправки трансляции WhatsApp Cloud API с номером метатеста?

Вы можете отправить тестовую трансляцию с платформы, используя тестовый метаномер. Однако рассылка с использованием тестового номера ограничена пятью получателями. Сначала необходимо добавить этих пятерых получателей в список номеров телефонов в инструментах Meta Developer.

Если вы не добавите получателей в этот список или попытаетесь отправить рассылку получателям, не входящим в этот список, вы получите следующее сообщение об ошибке:

Могу ли я удалить номер метатеста из подключенной учетной записи Cloud API?

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

Почему я вижу дубликаты контактов из одного и того же канала WhatsApp?

WhatsApp передает номер телефона контакта в формате , который отличается от формата E.164 , который использует response.io. Эта разница вызывает дублирование контактов из некоторых стран. Если это произойдет, свяжитесь с нами здесь.

Как изменить отображаемое имя моего облачного API?

Чтобы изменить отображаемое имя Cloud API, выполните следующие действия:

  1. Перейдите к своей учетной записи FBM > WhatsApp > Номер телефона. На этой странице отображается лимит и качество ваших сообщений.

  2. Наведите указатель мыши на значок карандаша рядом с отображаемым именем, чтобы включить редактирование.

  3. Нажмите Далее , чтобы отправить новое отображаемое имя в Meta для утверждения.

  4. Ожидайте подтверждения одобрения от Meta.

Какие шаги мне следует предпринять после одобрения моего нового отображаемого имени для облачного API?

Получив одобрение от Meta на ваше новое отображаемое имя, выполните следующие действия:

  1. Зарегистрируйте свой номер телефона повторно, используя новое утвержденное отображаемое имя.

  2. Выполните вызов POST API для проверки вашего номера телефона.

  3. Сделайте еще один вызов POST API, чтобы повторно зарегистрировать проверенный номер телефона.

  4. После успешного выполнения обновление отображаемого имени вашего Cloud API'будет завершено.

Почему я столкнулся с ошибкой "Ошибка проверки токена доступа: сеанс был аннулирован, поскольку пользователь сменил пароль или Facebook изменил сеанс из соображений безопасности" при попытке отправить сообщение?

Эта ошибка будет возникать, если вы недавно обновили ваши учетные данные Facebook, может нарушить соединение канала на нашей платформе, приводя к ошибкам при отправке сообщений.

Чтобы решить эту проблему, вам нужно обновить права канала на нашей платформе, используя ваши обновленные учетные данные Facebook. Этот процесс требует роль администратора. Обновив разрешения, вы'восстановите соединение с новыми учетными данными, гарантируя успешную отправку исходящих сообщений без возникновения ошибок.

Поделиться этой статьей
Telegram
Facebook
Linkedin
Twitter

Соответствующие статьи 👩‍💻

Бизнес-платформа WhatsApp (API) Быстрый старт
Быстро получите учетную запись WhatsApp Business API, чтобы начать общение с вашими клиентами.
WhatsApp Business Calling API
Узнайте, как использовать WhatsApp Business Calling API, чтобы принимать и совершать звонки.
Миграция телефонного номера на бизнес-платформу WhatsApp (API) response.io
Узнайте, как перенести свой номер телефона из других BSP в API WhatsApp Business от response.io.
Готово к входящим диалогам
Узнайте о окнах бесед, шаблонах сообщений и настройке простой входной точки для управления сообщениями от WhatsApp.
Шаблоны сообщений WhatsApp
Используйте шаблоны сообщений WhatsApp для работы с контактами в любое время.

Не удается найти то, что вы ищете? 🔎