help.chat-api.com

Как отправлять картинки, файлы и текстовые сообщения с помощью WhatsApp Business API

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

Очень кратко. Что такое шаблонные сообщения?

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

Сейчас Meta согласовывает практически все шаблонные сообщения, кроме тех, содержание которых явно противоречит торговой политике Meta. Шаблоны нельзя редактировать после их согласования, но можно создать новый, если в предыдущем варианте вас что-то перестало устраивать.

Как создать шаблонное сообщение?

Документация WABA. Шаблонное сообщение может быть создано с помощью метода /addTemplate нашей документации WABA. При этом важно соблюдать соотношение параметров, если вы указываете, что язык сообщения EN, то и содержание шаблонного сообщения должно быть на английском, если сообщение содержит кнопки, то не забудьте сформировать соответствующую под них информацию, например, Url, если это кнопка Call To Action. Подробно о кнопках мы говорили здесь. Узнать больше об условиях формирования шаблонных сообщений можно в этом материале.

Конструкторы шаблонных сообщений. Создать шаблонное сообщение можно и через встроенные конструкторы в личном кабинете Chat API и Meta Business Manager. Для этого в личном кабинете Chat API добавьте новый шаблон:

Укажите необходимые параметры и приложите нужные файлы

В Meta Business Manager порядок аналогичен:

info
Важно! В шаблонных сообщениях вы можете заранее приложить медиа файлы и документы. При этом на сегодняшний день отправка аудиосообщений через WABA недоступна. Документы можно отправлять только в формате PDF.
 

Meta также будет проверять и содержание вложений, поэтому при создании шаблона нужно приложить примеры отправляемых файлов. Раскроем небольшой лайфхак – единственное, что Meta не проверяет при создании шаблона – это переменные {1},{2},{3} … , которые после утверждения могут быть любыми. Отчасти на механике переменных и основаны наши «Быстрые сообщения».

Быстрые сообщения или Universal template от Chat API

Поскольку для команды Chat API очень важно обеспечивать комфортный и удобный подход к работе с WhatsApp Business API, то мы разработали для наших клиентов простой способ создания и отправки шаблонных сообщений – для этого достаточно воспользоваться функцией /sendMessage.

Быстрые сообщения – это альтернатива шаблонным сообщениям, для тех, кто не хочет тратить время на их создание. Когда вы отправляете любое текстовое сообщение вне 24-х часового диалогового окна, то мы автоматически превращаем их шаблонные сообщения, используя заранее утверждённые переменные.

Быстрые сообщения – это очень удобный инструмент, которые позволяет оперативно отправлять необходимые сообщения клиентам, без дополнительного ожидания и лишних действий, но у быстрых сообщений, по крайней мере пока, есть ряд ограничений, которые нужно учитывать:

info

1 – С помощью быстрых сообщений можно отправить текст, но для отправки файлов лучше воспользоваться конструктором шаблонов или же отправлять файлы в виде ссылок. Уже после открытия диалога вы можете воспользоваться функцией /sendFile;

2 – У шаблонных сообщений есть ограничения по количеству строк, пока их 7, но в скором времени мы их расширим;

3 – Быстрые сообщения недоступны сразу же после регистрации номера, должно пройти от 4 часов до суток, чтобы быстрые сообщения подгрузились в ваш личный кабинет.

Быстрые сообщения также позволяют обходить необходимость работы с методом /contacts, о котором мы поговорим ниже.

Как отправлять шаблонные сообщения?

После того, как вы создали шаблонное сообщение, и оно было согласовано с Meta, можно приступать к его отправке, но перед этим нужно совершить еще одно важное действие. Это проверка номера с помощью метода /contacts.

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

info

Лучше заранее определиться с базой контактов и отправлять их одним запросом, так как слишком частое использование метода /contacts приводит ко временному ограничению отправки запроса.

Вы можете проверить контакт с помощью данного метода, через наши инструменты тестирования или напрямую с помощью документации, если при этом вы получаете ответ Valid, то можно приступать к отправке.

Быстрые сообщений и метод /contacts

Как мы уже писали, для нас важно обеспечивать комфортную и бесперебойную работу с мессенджером, поэтому, если вы используете для открытия диалога /sendMessage, то мы автоматически задействуем /contacts для проверки номера, то есть вам не нужно лишний раз волноваться о проверке контактов перед отправкой, мы сделаем это за вас.

Напишите нам, если у вас остались вопросы по работе с кнопками WhatsApp Business API, мы с удовольствием вам поможем. Узнать все актуальные новости по работе сервиса вы можете в нашем телеграм канале. 

Была ли эта статья полезной?

Ваше мнение будет использовано для улучшения содержания статьи

Самый Многофункциональный WhatsApp API провайдер

Chat API работает с 2015 года и является одним из первых и самых крупных провайдеров в восточной Европе.

Вот несколько любопытных и важных цифр:

  • У нас огромная экспертиза в управлении докер контейнерами на масштабе с SLA 99.5+%;
  • Chat API задействует в своей работе более 200 серверов, с возможностью оперативного подключения еще 100;
  • 3200 ядер и 25 терабайт оперативной памяти;
  • 200+ методов и функций WhatsApp, которые продолжают пополняться;
  • Highload система, сервера Up Time 99,9%;
  • Служба поддержки 24\7;
Получить доступ к WhatsApp API