ΠŸΠ΅Ρ€Π΅ΠΉΡ‚ΠΈ ΠΊ ΡΠΎΠ΄Π΅Ρ€ΠΆΠ°Π½ΠΈΡŽ

SendTemplateButtons#

Π’Π½ΠΈΠΌΠ°Π½ΠΈΠ΅! ΠœΠ΅Ρ‚ΠΎΠ΄ Π²Ρ€Π΅ΠΌΠ΅Π½Π½ΠΎ Π½Π΅ Ρ€Π°Π±ΠΎΡ‚Π°Π΅Ρ‚

ΠŸΡ€ΠΈ Π²Ρ‹Π·ΠΎΠ²Π΅ ΠΌΠ΅Ρ‚ΠΎΠ΄Π° вСрнСтся ошибка 403.

ΠœΠ΅Ρ‚ΠΎΠ΄ ΠΏΡ€Π΅Π΄Π½Π°Π·Π½Π°Ρ‡Π΅Π½ для ΠΎΡ‚ΠΏΡ€Π°Π²ΠΊΠΈ сообщСния с ΠΈΠ½Ρ‚Π΅Ρ€Π°ΠΊΡ‚ΠΈΠ²Π½Ρ‹ΠΌΠΈ ΠΊΠ½ΠΎΠΏΠΊΠ°ΠΌΠΈ ΠΈΠ· пСрСчня шаблонов Π² Π»ΠΈΡ‡Π½Ρ‹ΠΉ ΠΈΠ»ΠΈ Π³Ρ€ΡƒΠΏΠΏΠΎΠ²ΠΎΠΉ Ρ‡Π°Ρ‚. Π‘ΠΎΠΎΠ±Ρ‰Π΅Π½ΠΈΠ΅ Π±ΡƒΠ΄Π΅Ρ‚ Π΄ΠΎΠ±Π°Π²Π»Π΅Π½ΠΎ Π² ΠΎΡ‡Π΅Ρ€Π΅Π΄ΡŒ Π½Π° ΠΎΡ‚ΠΏΡ€Π°Π²ΠΊΡƒ. Π‘ΠΎΠΎΠ±Ρ‰Π΅Π½ΠΈΠ΅ Π½Π° ΠΎΡ‚ΠΏΡ€Π°Π²ΠΊΡƒ хранится 24 часа Π² ΠΎΡ‡Π΅Ρ€Π΅Π΄ΠΈ ΠΈ Π±ΡƒΠ΄Π΅Ρ‚ ΠΎΡ‚ΠΏΡ€Π°Π²Π»Π΅Π½ΠΎ сразу ΠΆΠ΅ послС Π°Π²Ρ‚ΠΎΡ€ΠΈΠ·Π°Ρ†ΠΈΠΈ Ρ‚Π΅Π»Π΅Ρ„ΠΎΠ½Π°. Π‘ΠΊΠΎΡ€ΠΎΡΡ‚ΡŒ ΠΎΡ‚ΠΏΡ€Π°Π²ΠΊΠΈ сообщСний ΠΈΠ· ΠΎΡ‡Π΅Ρ€Π΅Π΄ΠΈ Ρ€Π΅Π³ΡƒΠ»ΠΈΡ€ΡƒΠ΅Ρ‚ ΠΏΠ°Ρ€Π°ΠΌΠ΅Ρ‚Ρ€ Π˜Π½Ρ‚Π΅Ρ€Π²Π°Π» ΠΎΡ‚ΠΏΡ€Π°Π²ΠΊΠΈ сообщСний.

Запрос#

Для ΠΎΡ‚ΠΏΡ€Π°Π²ΠΊΠΈ трСбуСтся Π²Ρ‹ΠΏΠΎΠ»Π½ΠΈΡ‚ΡŒ запрос ΠΏΠΎ адрСсу:

POST
{{apiUrl}}/waInstance{{idInstance}}/sendTemplateButtons/{{apiTokenInstance}}

Для получСния ΠΏΠ°Ρ€Π°ΠΌΠ΅Ρ‚Ρ€ΠΎΠ² запроса apiUrl, idInstance ΠΈ apiTokenInstance ΠΎΠ±Ρ€Π°Ρ‚ΠΈΡ‚Π΅ΡΡŒ ΠΊ Ρ€Π°Π·Π΄Π΅Π»Ρƒ ΠŸΠ΅Ρ€Π΅Π΄ Π½Π°Ρ‡Π°Π»ΠΎΠΌ Ρ€Π°Π±ΠΎΡ‚Ρ‹.

ΠžΡΠΎΠ±Π΅Π½Π½ΠΎΡΡ‚ΠΈ ΠΏΡ€ΠΈ Ρ€Π°Π±ΠΎΡ‚Π΅ с ΠΊΠ½ΠΎΠΏΠΊΠ°ΠΌΠΈ#

  • ΠΊΠ½ΠΎΠΏΠΊΠΈ-ссылки совмСстимы с ΠΊΠ½ΠΎΠΏΠΊΠ°ΠΌΠΈ Π½ΠΎΠΌΠ΅Ρ€Π°ΠΌΠΈ, Π½ΠΎ Π½Π΅ совмСстимы с ΠΊΠ½ΠΎΠΏΠΊΠ°ΠΌΠΈ-ΠΎΡ‚Π²Π΅Ρ‚Π°ΠΌΠΈ;
  • ΠΊΠ½ΠΎΠΏΠΊΠΈ с Ρ‚Π΅Π»Π΅Ρ„ΠΎΠ½Π½Ρ‹ΠΌ Π½ΠΎΠΌΠ΅Ρ€ΠΎΠΌ совмСстимы с ΠΊΠ½ΠΎΠΏΠΊΠ°ΠΌΠΈ ссылками, Π½ΠΎ Π½Π΅ совмСстимы с ΠΊΠ½ΠΎΠΏΠΊΠ°ΠΌΠΈ-ΠΎΡ‚Π²Π΅Ρ‚Π°ΠΌΠΈ;
  • ΠΊΠ½ΠΎΠΏΠΊΠΈ с быстрыми ΠΎΡ‚Π²Π΅Ρ‚Π°ΠΌΠΈ Π½Π΅ совмСстимы с ΠΊΠ½ΠΎΠΏΠΊΠ°ΠΌΠΈ Π½ΠΎΠΌΠ΅Ρ€Π°ΠΌΠΈ ΠΈ ΠΊΠ½ΠΎΠΏΠΊΠ°ΠΌΠΈ ссылками.

ΠŸΠ°Ρ€Π°ΠΌΠ΅Ρ‚Ρ€Ρ‹ запроса#

ΠŸΠ°Ρ€Π°ΠΌΠ΅Ρ‚Ρ€ Π’ΠΈΠΏ ΠžΠ±ΡΠ·Π°Ρ‚Π΅Π»ΡŒΠ½Ρ‹ΠΉ ОписаниС
chatId string Π”Π° Π˜Π΄Π΅Π½Ρ‚ΠΈΡ„ΠΈΠΊΠ°Ρ‚ΠΎΡ€ Ρ‡Π°Ρ‚Π°
message string Π”Π° ВСкст сообщСния. ΠŸΠΎΠ΄Π΄Π΅Ρ€ΠΆΠΈΠ²Π°ΡŽΡ‚ΡΡ символы emoji πŸ˜ƒ
footer string НСт Подвал сообщСния. Π£Π΄ΠΎΠ±Π΅Π½ для Π²ΠΈΠ·ΡƒΠ°Π»ΡŒΠ½ΠΎΠ³ΠΎ выдСлСния тСкста, ΠΊΠΎΡ‚ΠΎΡ€Ρ‹ΠΉ относится ΠΊ ΠΊΠ½ΠΎΠΏΠΊΠ°ΠΌ
templateButtons array Π”Π° Π˜Π½Ρ‚Π΅Ρ€Π°ΠΊΡ‚ΠΈΠ²Π½Ρ‹Π΅ ΠΊΠ½ΠΎΠΏΠΊΠΈ сообщСния
quotedMessageId string НСт Π˜Π΄Π΅Π½Ρ‚ΠΈΡ„ΠΈΠΊΠ°Ρ‚ΠΎΡ€ Ρ†ΠΈΡ‚ΠΈΡ€ΡƒΠ΅ΠΌΠΎΠ³ΠΎ сообщСния,Ссли ΡƒΠΊΠ°Π·Π°Π½ Ρ‚ΠΎ сообщСниС отправится с Ρ†ΠΈΡ‚ΠΈΡ€ΠΎΠ²Π°Π½ΠΈΠ΅ΠΌ ΡƒΠΊΠ°Π·Π°Π½Π½ΠΎΠ³ΠΎ сообщСния Ρ‡Π°Ρ‚Π°

Поля массива templateButtons

ΠŸΠ°Ρ€Π°ΠΌΠ΅Ρ‚Ρ€ Π’ΠΈΠΏ ОписаниС
index integer Π˜Π΄Π΅Π½Ρ‚ΠΈΡ„ΠΈΠΊΠ°Ρ‚ΠΎΡ€ ΠΊΠ½ΠΎΠΏΠΊΠΈ
urlButton object ΠΊΠ½ΠΎΠΏΠΊΠ° с ссылкой
callButton object ΠΊΠ½ΠΎΠΏΠΊΠ° Π²Ρ‹Π·ΠΎΠ²Π°
quickReplyButton object обычная ΠΊΠ½ΠΎΠΏΠΊΠ°

Поля ΠΎΠ±ΡŠΠ΅ΠΊΡ‚Π° urlButton

ΠŸΠ°Ρ€Π°ΠΌΠ΅Ρ‚Ρ€ Π’ΠΈΠΏ ОписаниС
displayText string ВСкст ссылки
url string Π²Π΅Π± ссылка

Поля ΠΎΠ±ΡŠΠ΅ΠΊΡ‚Π° callButton

ΠŸΠ°Ρ€Π°ΠΌΠ΅Ρ‚Ρ€ Π’ΠΈΠΏ ОписаниС
displayText string ВСкст ссылки
phoneNumber string Π½ΠΎΠΌΠ΅Ρ€ Ρ‚Π΅Π»Π΅Ρ„ΠΎΠ½Π°

Поля ΠΎΠ±ΡŠΠ΅ΠΊΡ‚Π° quickReplyButton

ΠŸΠ°Ρ€Π°ΠΌΠ΅Ρ‚Ρ€ Π’ΠΈΠΏ ОписаниС
displayText string ВСкст Π½Π° ΠΊΠ½ΠΎΠΏΠΊΠ΅
id string ΠΈΠ΄Π΅Π½Ρ‚ΠΈΡ„ΠΈΠΊΠ°Ρ‚ΠΎΡ€ ΠΊΠ½ΠΎΠΏΠΊΠΈ

Максимальная Π΄Π»ΠΈΠ½Π° тСкстового сообщСния составляСт 4096 символов

ΠŸΡ€ΠΈΠΌΠ΅Ρ€ Ρ‚Π΅Π»Π° запроса#

ΠžΡ‚ΠΏΡ€Π°Π²ΠΊΠ° сообщСния Π² Π»ΠΈΡ‡Π½Ρ‹ΠΉ Ρ‡Π°Ρ‚:

{
    "chatId": "79876543210@c.us",
    "message": "Hello",
    "footer": "What kind of action will you choose?",
    "templateButtons": [
            {"index": 1, "urlButton": {"displayText": "⭐ Star us on GitHub!", "url": "https://github.com/green-api"}},
            {"index": 2, "callButton": {"displayText": "Call us", "phoneNumber": "+1 (234) 5678-901"}},
            {"index": 3, "quickReplyButton": {"displayText": "Plain button", "id": "plainButtonId"}}
        ]
}

ΠžΡ‚Π²Π΅Ρ‚#

Поля ΠΎΡ‚Π²Π΅Ρ‚Π°#

ПолС Вип ОписаниС
idMessage string Π˜Π΄Π΅Π½Ρ‚ΠΈΡ„ΠΈΠΊΠ°Ρ‚ΠΎΡ€ ΠΎΡ‚ΠΏΡ€Π°Π²Π»Π΅Π½Π½ΠΎΠ³ΠΎ сообщСния

ΠŸΡ€ΠΈΠΌΠ΅Ρ€ Ρ‚Π΅Π»Π° ΠΎΡ‚Π²Π΅Ρ‚Π°#

{
    "idMessage": "3EB0C767D097B7C7C030"
}

ΠŸΡ€ΠΈΠΌΠ΅Ρ€ отобраТСния Ρƒ получатСля#

Кнопка с ΠΎΠ±Ρ€Π°Ρ‚Π½Ρ‹ΠΌ Π·Π²ΠΎΠ½ΠΊΠΎΠΌ
ΠŸΡ€ΠΈΠΌΠ΅Ρ€ отобраТСния ΠΊΠ½ΠΎΠΏΠΎΠΊ

Кнопка со ссылкой
ΠŸΡ€ΠΈΠΌΠ΅Ρ€ отобраТСния ΠΊΠ½ΠΎΠΏΠΎΠΊ

Кнопка с быстрым ΠΎΡ‚Π²Π΅Ρ‚ΠΎΠΌ
ΠŸΡ€ΠΈΠΌΠ΅Ρ€ отобраТСния ΠΊΠ½ΠΎΠΏΠΎΠΊ

Ошибки SendTemplateButtons#

ΠŸΠ΅Ρ€Π΅Ρ‡Π΅Π½ΡŒ ΠΎΠ±Ρ‰ΠΈΡ… для всСх ΠΌΠ΅Ρ‚ΠΎΠ΄ΠΎΠ² ошибок смотритС Π² Ρ€Π°Π·Π΄Π΅Π»Π΅ Π‘Ρ‚Π°Π½Π΄Π°Ρ€Ρ‚Π½Ρ‹Π΅ ошибки

Π’ΠΎΠ·ΠΌΠΎΠΆΠ½Ρ‹Π΅ ошибки

ΠŸΡ€ΠΈ использовании ΠΌΠ΅Ρ‚ΠΎΠ΄Π° SendTemplateButtons сообщСния ΠΌΠΎΠ³ΡƒΡ‚ Π½Π΅ ΠΎΡ‚ΠΎΠ±Ρ€Π°ΠΆΠ°Ρ‚ΡŒΡΡ Π² Π²Π΅Π±, дСсктоп ΠΈ мобильной вСрсиях прилоТСния. Π’ΠΎΠ·ΠΌΠΎΠΆΠ½ΠΎΡΡ‚ΡŒ ΠΎΡ‚ΠΏΡ€Π°Π²ΠΊΠΈ сообщСний с ΠΊΠ½ΠΎΠΏΠΊΠ°ΠΌΠΈ Ρ€Π΅Π°Π»ΠΈΠ·ΠΎΠ²Π°Π½Π° Π½Π°ΠΌΠΈ Π½ΠΈΠ·ΠΊΠΎΡƒΡ€ΠΎΠ²Π½Π΅Π²Ρ‹ΠΌ способом. ΠžΡ„ΠΈΡ†ΠΈΠ°Π»ΡŒΠ½Ρ‹ΠΉ ΠΊΠ»ΠΈΠ΅Π½Ρ‚ WhatsApp-Web Π½Π΅ прСдоставляСт Ρ„ΡƒΠ½ΠΊΡ†ΠΈΠΈ ΠΎΡ‚ΠΏΡ€Π°Π²ΠΊΠΈ ΠΊΠ½ΠΎΠΏΠΎΠΊ. Π’ большСй стСпСни, ΡΡ‚Π°Π±ΠΈΠ»ΡŒΠ½ΠΎΡΡ‚ΡŒ Ρ€Π°Π±ΠΎΡ‚Ρ‹ ΠΌΠ΅Ρ‚ΠΎΠ΄Π° SendTemplateButtons Π½Π΅ зависит ΠΎΡ‚ нас, WhatsApp постоянно вносит измСнСния Π² ΠΈΡ… Ρ€Π°Π±ΠΎΡ‚Ρƒ.

Π Π΅ΠΊΠΎΠΌΠ΅Π½Π΄ΡƒΠ΅ΠΌ всСгда Π΄ΡƒΠ±Π»ΠΈΡ€ΠΎΠ²Π°Ρ‚ΡŒ ΠΊΠ½ΠΎΠΏΠΊΠΈ ΠΎΠ±Ρ‹Ρ‡Π½Ρ‹ΠΌΠΈ сообщСниями.

НапримСр ΠΈΡΠΏΠΎΠ»ΡŒΠ·ΠΎΠ²Π°Ρ‚ΡŒ Ρ†ΠΈΡ„Ρ€Ρ‹ для опрСдСлСния Π²Ρ‹Π±ΠΎΡ€Π°.

Π’Ρ‹Π±Π΅Ρ€Π΅Ρ‚Π΅ дСйствиС:

1 - дСйствиС 1

2 - дСйствиС 2

3 - дСйствиС 3

ΠŸΡ€ΠΈΠΌΠ΅Ρ€ ΠΊΠΎΠ΄Π° Π½Π° cURL#

curl --location --request POST '{{apiUrl}}/waInstance{{idInstance}}/sendTemplateButtons/{{apiTokenInstance}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "chatId": "79876543210@c.us",
    "message": "Hello",
    "footer": "What kind of action will you choose?",
    "templateButtons": [
            {"index": 1, "urlButton": {"displayText": "⭐ Star us on GitHub!", "url": "https://github.com/green-api"}},
            {"index": 2, "callButton": {"displayText": "Call us", "phoneNumber": "+1 (234) 5678-901"}},
            {"index": 3, "quickReplyButton": {"displayText": "Plain button", "id": "plainButtonId"}}
        ]
}'