1) Отправка уведомлений в WhatsApp (1msg)
2) Отправка уведомлений в WhatsApp (Green API)
Отправка уведомлений в WhatsApp (1msg)
Для того, чтобы отправлять push уведомления по различным событиям из заявки по номеру в WhatsApp. Для этого нам потребуется личный кабинет в 1msg, чьё API будет использоваться для отправки уведомлений.
Пример 1. Отправка сообщений в качестве обычных сообщений
Пример 2. Отправка сообщений в качестве шаблона
В зависимости от того, по каким действиям Вы хотите получать уведомления, необходимо выбрать обязательные и дополнительные условия, при выполнении которых будет осуществляться отправка уведомлений. В нашем примере уведомление будет отправляться клиенту при создании новой заявки, если в его карточке пользователя указан номер телефона. Перейдите в меню "Диспетчер" в HelpDeskEddy и создайте новое правило. В условиях укажите в каких случаях должно отправляться уведомление, а в действиях выберите "Отправить вебхук":
Пример 1. Отправка сообщений в качестве обычных сообщений
В поле URL необходимо вставить api url вашего инстанса. Найти его и api токен вы можете в личном кабинете 1msg:
api_url/sendMessage
Разберем тело вебхука:
{
"token": "api_key",
"body": "Заявка была создана. Содержимое: $strip_tags({answer_first})",
"phone": "{creator_phone}"
}
В параметре “token” вы указываете api key из личного кабинета. В “body” указываете текст сообщения, а в параметре “phone” - номер телефона пользователя.
В теле вебхука используются следующие теги:
1. {creator_phone} - тег номера телефона создателя заявки.
2. $strip_tags({answer_first}) - тег answer_first с содержимым первого ответа в заявке. Тег обернули в $strip_tags(), чтобы избежать ошибки от WhatsApp в случае отправки неподдерживаемых тегов.
Пример 2. Отправка сообщений в качестве шаблона
В поле URL необходимо вставить api url вашего инстанса. Найти его и api токен вы можете в личном кабинете 1msg:
api_url/sendTemplate
Разберем тело вебхука:
{
"token": "api_key",
"template":"test_greetings_with_name",
"language":{
"policy":"deterministic",
"code":"ru"
},
"namespace":"a****3",
"params":[{
"type":"body",
"parameters":[{
"type":"text",
"text":"Заявка была создана. Содержимое: $strip_tags({answer_first})"
}]}],
"phone":"{creator_phone}"
}
1. Token - указываете api key из личного кабинета 1msg
2. Template - указываете название шаблона (1)
3. Namespace - указываете соответствующий токен (2)
4. Code - указываете код языка шаблона (3)
5. Text - содержание сообщения
6. Phone - номер телефона
Найти данные шаблона вы можете в настройках канала связи:
Обратите внимание, номер телефона в карточке пользователя должен быть указан через 7 (например: 74993468744), иначе уведомление отправлено не будет!
Также отправить можно только 2 сообщения в сутки любым из методов, если пользователь не откроет диалоговое окно. Диалоговое окно закрывается спустя 24 часа. Обратите внимание, что за использование шаблонов и инициацию переписки, провайдером может взиматься дополнительная плата
Отправка уведомлений в WhatsApp (Green API)
Для того, чтобы отправлять push уведомления по различным событиям из заявки по номеру в WhatsApp. Для этого нам потребуется личный кабинет в Green API, чьё API будет использоваться для отправки уведомлений.
В зависимости от того, по каким действиям Вы хотите получать уведомления, необходимо выбрать обязательные и дополнительные условия, при выполнении которых будет осуществляться отправка уведомлений. В нашем примере уведомление будет отправляться клиенту при создании новой заявки, если в его карточке пользователя указан номер телефона. Перейдите в меню "Диспетчер" в HelpDeskEddy и создайте новое правило. В условиях укажите в каких случаях должно отправляться уведомление, а в действиях выберите "Отправить вебхук":
В поле URL необходимо вставить ссылку с токеном вашего инстанса, через который будет осуществляться отправка: https://1*/waInstance2*/sendMessage/3*. Эти данные (вместо 1, 2, 3) вы можете найти в настройках инстанса в личном кабинете WhatsApp:
Содержимое шаблона можно выбирать на Ваше усмотрение, при помощи тегов. С примером содержимого можно ознакомиться ниже:
{
"chatId": "{creator_phone}@c.us",
"message": "Ваша заявка была зарегистрирована", Содержимое: $strip_tags({answer_first})
}
Где:
{creator_phone} - тег номера телефона создателя заявки.
- $strip_tags({answer_first}) - тег answer_first с содержимым первого ответа в заявке. Тег обернули в $strip_tags(), чтобы избежать ошибки от WhatsApp в случае отправки неподдерживаемых тегов.
Обратите внимание, номер телефона в карточке пользователя должен быть указан через 7 (например: 74993468744), иначе уведомление отправлено не будет!