Отправка сообщений | Документация для разработчиков

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

С помощью API можно отправлять следующие типы сообщений.

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

Рекомендации по отправке качественных сообщений:

Статус вашего рабочего телефонного номера, рейтинг качества и лимиты сообщений отображаются в WhatsApp Manager > Инструменты учетной записи > Панель « Телефонные номера» .

Следует отметить, что для номеров с высокой интенсивностью трафика нормально испытывать изменения качества в течение коротких промежутков времени (даже в течение нескольких минут).

Каждый раз, когда пользователь WhatsApp отправляет вам сообщение или звонит , запускается 24-часовой таймер, называемый окном обслуживания клиентов (или обновляется, если оно уже было запущено).

Когда окно обслуживания клиентов открыто между вами и пользователем, вы можете отправлять сообщения любого типа . Если окно обслуживания между вами и пользователем не открыто, вы можете отправлять пользователю только шаблонные сообщения, поскольку шаблонные сообщения — это единственный тип сообщений, которые можно отправлять вне окна обслуживания клиентов.

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

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

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

Вы можете сообщить пользователю WhatsApp, что прочитали его сообщение отметив его как прочитанное . В этом случае под сообщением пользователя появятся две синие галочки (называемые «уведомления о прочтении»).

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

Вы можете отправить сообщение пользователю WhatsApp в виде контекстного ответа , который цитирует предыдущее сообщение во всплывающем окне:

Это облегчает пользователю понимание того, на какое именно сообщение вы отвечаете.

В запросах на отправку сообщений поддерживаются знаки плюса ( + ), дефисы ( - ), скобки ( , ) и

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

Например, если ваша компания находится в Индии (телефонный код страны 91 ) и вы отправляете сообщение на следующий номер телефона клиента в различных форматах:

Номер в запросе на отправку сообщения	Номер сообщения, доставленного по адресу	Исход
+16315551234	+16315551234	Правильное число
+1 (631) 555-1234	+16315551234	Правильное число
(631) 555-1234	+916315551234	Возможно, неверный номер
1 (631) 555-1234	+9116315551234	Возможно, неверный номер

Примечание: Для Бразилии и Мексики дополнительный префикс телефонного номера может быть изменен с помощью облачного API. Это стандартное поведение системы и не считается ошибкой.

Если вы используете ссылку ( link ) на медиафайл на вашем сервере (в отличие от идентификатора ( id ) файла, загруженного вами на наши серверы), WhatsApp Cloud API внутренне кэширует этот файл на фиксированный период времени в 10 минут. Мы будем использовать кэшированный файл в последующих запросах на отправку сообщений, если ссылка в последующих запросах на отправку сообщений совпадает со ссылкой в ​​исходном запросе на отправку сообщения.

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

Например:

При отправке серии сообщений порядок их доставки не гарантирует совпадения с порядком ваших API-запросов. Если вам необходимо обеспечить последовательность доставки сообщений, подтвердите получение доставки в сообщений о статусе перед отправкой следующего сообщения в вашей последовательности.

Если нам не удаётся доставить сообщение пользователю WhatsApp, мы будем повторять попытку доставки в течение периода времени, известного как время жизни (TTL) или срок действия сообщения.

Вы можете настроить значение TTL по умолчанию для шаблонов аутентификации и служебных шаблонов, а также для маркетинговых шаблонов, отправляемых с помощью API маркетинговых сообщений для WhatsApp. Подробнее об этом см. в нашем документе «Time-to-live»

Сообщения, которые не могут быть доставлены в течение заданного по умолчанию или пользовательского времени жизни (TTL), отбрасываются.

до истечения TTL вы не получили веб-перехватчик сообщений о статусе с пометкой « доставлено»

Если отправка сообщения завершается неудачей ( статус установлен на "неудачно "), может возникнуть небольшая задержка перед получением веб-перехватчика, поэтому, возможно, стоит предусмотреть небольшой буфер, прежде чем считать, что сообщение было отброшено.

Если у вас возникли проблемы с доставкой сообщений, см. раздел «Сообщение не доставлено» .