Skip to main content
POST
Този endpoint изпраща WhatsApp съобщение чрез предварително одобрен шаблон. Шаблонните съобщения са задължителни при започване на разговор с потребител за първи път или при изпращане на съобщения извън 24-часовия прозорец за съобщения.
Този endpoint има ограничение от 5 заявки в секунда на потребител.

Тяло на заявката

integer
required
ID на WhatsApp изпращача от който да се изпрати (получен от endpoint-а Get Senders)
integer
required
ID на шаблона за съобщение който да се използва (получен от endpoint-а Get Templates)
string
required
Телефонния номер на получателя в международен формат (например, +1234567890)
string
Името на получателя, максимум 255 символа (използва се за проследяване на разговори и CRM цели)
object
Двойки ключ-стойност за променливите на шаблона. Ключовете трябва да съответстват на имената на променливите от шаблона. Ако шаблонът има променливи {{1}}, {{2}}, и т.н., подайте ги като {"1": "стойност1", "2": "стойност2"} или използвайте именуваните ключове от масива variables на шаблона.

Полета в отговора

boolean
Дали съобщението е изпратено успешно
integer
ID на разговора (нов или съществуващ) свързан с това съобщение
integer
ID на записа на съобщението в разговора
integer
ID на записа на WhatsApp съобщението
string
Twilio message SID за проследяване на доставката
string
Началният статус на доставка на съобщението (например, queued, sent)

Отговори при грешки

Забележки

  • Шаблонните съобщения трябва да използват одобрени шаблони. Шаблони със статус pending или rejected ще се провалят.
  • Изпращачът трябва да е online. Офлайн изпращачи не могат да изпращат съобщения.
  • Разходите за съобщения се приспадат автоматично от баланса на акаунта ви (кредити за tenant потребители, минути за директни потребители).
  • След изпращане на шаблонно съобщение се отваря 24-часов прозорец за съобщения. През този прозорец можете да изпращате свободни съобщения без нужда от шаблон.
  • Ако разговор със получателя вече съществува, съобщението се добавя към съществуващия разговор.
  • Ограничение на честотата: 5 заявки в секунда на потребител.