help.chat-api.com

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

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

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

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

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

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

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

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

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

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

info
Важно! В шаблонных сообщениях вы можете заранее приложить медиа файлы и документы. При этом на сегодняшний день отправка аудиосообщений через MESAPI недоступна. Файлы могут быть любыми, которые относятся к формату медиа (MIME type) - pdf, csv, sql, doc и т.д.
 

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

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

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

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

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

info

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

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

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

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

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

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

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

info

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

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

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

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

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

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

Также вы можете создать шаблон с файлами через само API, используя нашу документацию.

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

После открытия диалогового окна, вы можете отправлять файлы с помощью /sendFile.

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

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

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

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

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

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

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