Теперь вы можете перенести свою подключенную учетную запись 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
Управление профилем API WhatsApp Cloud
Если необходимо внести изменения или проверить ваш профиль WhatsApp Cloud API, это можно сделать на платформе respond.io.
Шаг 1: Перейдите в Настройки рабочего пространства > Нажмите Каналы.
Шаг 2: Найдите канал WhatsApp Cloud API > Нажмите Управлять > Профиль.
Шаг 3: Нажмите «Синхронизировать профиль», чтобы получить последнюю информацию о профиле WhatsApp Business из WhatsApp.
Шаг 4: При необходимости отредактируйте следующую информацию.
Поля | Описание |
|---|---|
Фото профиля | Изображение, отображаемое в качестве изображения профиля бизнес-аккаунта WhatsApp. Рекомендуемый размер изображения — 640x640. |
О | Текст "О" бизнеса. Этот текст отображается в профиле компании'под ее изображением профиля, номером телефона и кнопками контактов. |
Адрес | Адрес компании. Максимум 256 символов. |
Описание | Описание бизнеса. Максимум 512 символов. |
Электронная почта | Адрес электронной почты (в допустимом формате) для связи с компанией. Максимум 128 символов. |
Вертикальный | Отрасль бизнеса. Должно быть одним из следующих допустимых значений: Автомобильная, Красота, Спа и Салон, Одежда и Аксессуары, Образование, Развлечения, Планирование событий и услуги, Финансы и банковская деятельность, Продукты и бакалея, Государственные услуги, Отель и размещение, Медицинские и здравоохранения, Некоммерческие, Профессиональные услуги, Розничная Торговля и покупки, Путешествия и транспорт, Ресторан, Другое. Вертикаль бизнеса не может быть возвращена к пустому значению после ее создания. |
Веб-сайт | URL-адреса (включая http:// или https://), связанные с бизнесом (например, веб-сайт, страница Facebook, Instagram). Максимум 2 веб-сайта, каждый длиной не более 256 символов. |
Шаг 5: Проверьте информацию и нажмите «Сохранить изменения».
Управление шаблонами сообщений WhatsApp
Перед отправкой шаблона сообщения контакту на платформе response.io убедитесь, что вы'выполнили следующее:
- Отправил шаблон сообщения на утверждение. - Добавил утвержденный шаблон сообщения в рабочее пространство, синхронизировав шаблон сообщения.
Отправка шаблонов сообщений
Шаг 1:Перейдите вНастройки рабочего пространства> НажмитеКаналы.
Шаг 2:Найдите канал API WhatsApp Cloud > НажмитеУправление.
Шаг 3: Нажмите «Шаблоны» > «Отправить шаблон» , чтобы отправить шаблон сообщения на утверждение.
Шаг 4: Заполните необходимую информацию для создания шаблона.
Поле | Описание |
|---|---|
Название шаблона | Имя может содержать только строчные буквы, цифры и символы подчеркивания (_). |
Категория | Категория, к которой принадлежит шаблон сообщения. |
Язык | Язык, на котором написан шаблон. |
Шаг 5: Создайте сообщение, заполнив необходимые компоненты, затем просмотрите сообщение в разделе предварительного просмотра. Вы можете включить параметры {{1}}, {{2}}и т. д. в качестве заполнителей для заполнения персонализированным содержимым.
Строительный блок | Описание |
|---|---|
Тело | Тело содержит самый важный текст вашего шаблона. Поддерживается только текст. Вы можете использовать разметку для форматирования содержимого этого блока. Узнайте больше здесь. |
Заголовок | Заголовок необязателен и служит названием или заголовком вашего шаблона. Поддерживается следующее: |
Нижний колонтитул | Нижний колонтитул необязателен и поддерживает только текст. Его можно использовать для предоставления дополнительной информации в шаблоне сообщения. |
Кнопка | Кнопка необязательна и добавляет интерактивности вашим шаблонам. Доступно два типа: |
Шаг 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, которые приложение или пользователь может выполнить в течение определенного периода времени, определяемого каналом. Подробнее об ограничениях скорости для этого канала можно узнать здесь.
Часто задаваемые вопросы и устранение неполадок
Невозможно отправить сообщения
Убедитесь, что номер, который вы'подключили к платформе, является номером 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?
Номер телефона, используемый для WhatsApp Cloud API, нельзя использовать в личном или деловом приложении WhatsApp. Вам придется удалить учетную запись в приложении WhatsApp, прежде чем вы сможете использовать номер для регистрации в WhatsApp Cloud API.
Вы по-прежнему сможете использовать номер для других целей, например, для звонков и получения SMS, после его регистрации на платформе WhatsApp Business.
После использования телефона для API WhatsApp Cloud вы больше не сможете использовать этот номер в приложении WhatsApp Business.
Нужна ли проверка бизнеса для начала использования Cloud API?
Чтобы начать отправлять сообщения в WhatsApp, не обязательно проходить проверку Facebook Business. Без подтверждения личности ваш бизнес все равно сможет:
Отвечайте на неограниченное количество разговоров, инициированных пользователями.
Отправляйте бизнес-инициированные беседы (шаблоны сообщений) 250 уникальным клиентам в течение 24 часов.
Зарегистрируйте до 2 номеров телефона.
Предприятия могут инициировать проверку бизнеса только тогда, когда они'готовы масштабировать деловые разговоры или хотят стать официальным бизнес-аккаунтом.
Могу ли я просмотреть аналитику своих разговоров в аккаунте WhatsApp Business?
Да, вы можете отслеживать аналитику сообщений и расходов в режиме реального времени для своего бизнес-аккаунта WhatsApp на вкладке Аналитика вашего Meta WhatsApp Manager. Подробнее читайте здесь.
Каковы лимиты на сообщения WhatsApp?
Лимиты сообщений определяют максимальное количество уникальных пользователей WhatsApp, с которыми портфель бизнеса может начать инициированные бизнесом разговоры в течение 24 часов. Этот лимит делится между всеми номерами телефонов в портфеле.
Эти ограничения не распространяются на разговоры, инициированные пользователем. Разговор, инициированный бизнесом, начинается, когда первое сообщение доставлено клиенту и продолжается в течение 24 часов.
Распространенное недоразумение заключается в том, что каждое сообщение учитывается в лимите — на самом деле, несколько сообщений, отправленных одному и тому же пользователю в течение 24 часов, считаются одним разговором.
Подробнее читайте здесь.
Как добавить способ оплаты в мой аккаунт WhatsApp Business?
Вы можете добавить способ оплаты в свою учетную запись WhatsApp Business в Business Manager. Узнайте, как добавить способ оплаты в свой аккаунт WhatsApp Business здесь.
Почему мое сообщение не было отправлено из-за ошибки «Проблема с платежом для подтверждения соответствия требованиям бизнеса»?
Вероятнее всего, это связано с тем, что вы превысили ежемесячный порог бесплатного уровня, не указав допустимый способ оплаты. Чтобы решить эту проблему, добавьте действительный способ оплаты.
Каковы цены на WhatsApp Cloud API?
С 1 июля 2025 года WhatsApp Cloud API использует гибридную модель ценообразования. Сервисные разговоры (когда вы отвечаете клиенту в течение 24 часов) тарифицируются по разговору. Шаблонные сообщения — маркетинговые, утилитарные и аутентификационные — тарифицируются за каждое отправленное сообщение. Утилитарные шаблоны бесплатны, если отправляются в течение 24 часов, в то время как аутентификационные и маркетинговые шаблоны всегда оплачиваются за каждое сообщение. Шаблоны повышенного объема для утилитарных и аутентификационных сообщений получают автоматические скидки по уровням. Бесплатные разговоры начального уровня из рекламы или CTA на странице открывают 72-часовое окно, в течение которого все типы сообщений бесплатны.
Узнайте больше о цены WhatsApp здесь.
Как удалить номер телефона из бизнес-аккаунта?
Для удаления номера телефона необходимо выполнить несколько требований и шагов, подробнее здесь.
Могу ли я использовать respond.io для отправки трансляции WhatsApp Cloud API с номером теста Meta?
Вы можете отправить тестовую трансляцию с платформы, используя номер теста Meta. Однако рассылка с использованием тестового номера ограничена пятью получателями. Сначала необходимо добавить этих пятерых получателей в список номеров телефонов в инструментах Meta Developer.
Если вы не добавите получателей в этот список или попытаетесь отправить рассылку получателям, не входящим в этот список, вы получите следующее сообщение об ошибке:
Могу ли я удалить номер метатеста из подключенной учетной записи Cloud API?
Нет, этот номер автоматически предоставляется всем аккаунтам для отправки тестовых сообщений и не может быть удален. Просто будьте внимательны и учтите, что это тестовый номер, который не следует использовать в других целях.
Почему я вижу дублирующиеся контакты из одного и того же канала WhatsApp?
WhatsApp передает номер телефона контакта в формате, который отличается от формата E.164, используемого respond.io. Из-за этой разницы контакты из некоторых стран дублируются. Если это произойдет, свяжитесь с нами здесь.
Как изменить отображаемое имя моего облачного API?
Чтобы изменить отображаемое имя Cloud API, выполните следующие действия:
Перейдите к своей учетной записи FBM > WhatsApp > Номер телефона. На этой странице отображается лимит и качество ваших сообщений.
Наведите указатель мыши на значок карандаша рядом с отображаемым именем, чтобы включить редактирование.
Нажмите Далее , чтобы отправить новое отображаемое имя в Meta для утверждения.
Ожидайте подтверждения одобрения от Meta.
Какие шаги мне следует предпринять после одобрения моего нового отображаемого имени для облачного API?
Получив одобрение от Meta на ваше новое отображаемое имя, выполните следующие действия:
Зарегистрируйте свой номер телефона повторно, используя новое утвержденное отображаемое имя.
Выполните вызов POST API для проверки вашего номера телефона.
Сделайте еще один вызов POST API, чтобы повторно зарегистрировать проверенный номер телефона.
После успешного выполнения обновление отображаемого имени вашего Cloud API будет завершено.
Почему я столкнулся с ошибкой «Ошибка проверки токена доступа: сеанс был аннулирован, поскольку пользователь сменил пароль или Facebook изменил сеанс по соображениям безопасности» при попытке отправить сообщение?
Эта ошибка может возникнуть, если вы недавно обновили свои учетные данные Facebook. Это может привести к нарушению соединения с каналом на нашей платформе, что приведет к ошибкам при отправке сообщений.
Чтобы решить эту проблему, вам необходимо обновить разрешения канала на нашей платформе, используя ваши обновленные учетные данные Facebook. Для этого процесса требуется роль администратора. Обновив разрешения, вы'восстановите соединение с новыми учетными данными, гарантируя успешную отправку исходящих сообщений без возникновения ошибок.
