Üzenettípusok

Kilenc üzenettípus, egyetlen kéréstörzs

A küldési kérés megnevez egy csatornát, egy címzettet és egy típust, a tartalom pedig a típus nevével megegyező kulcs alatt áll. Ezen az oldalon minden típust megtalál, a hozzá tartozó kéréstörzzsel és azzal együtt, hogy hol támogatott.

API-referencia megnyitása Csatornák összehasonlítása

Támogatási mátrix

Melyik csatorna melyik típust fogadja

A csatorna a capabilities mezőben jelzi, mit fogad. Ha olyan típust küld, amelyet a csatorna nem támogat, a válasz 400 unsupported_message_type, és semmit sem számítunk fel.

Üzenettípusok támogatása csatornatípusonként
Típus	WhatsApp	SMS	SMS OTP	Telegram	Messenger	Instagram	TikTok
Szöveg`text`	Támogatott	Támogatott	Támogatott	Támogatott	Támogatott	Támogatott	Támogatott
Mellékletek`attachments`	Támogatott	Támogatott	Nem támogatott	Támogatott	Támogatott	Támogatott	Támogatott
Sablon`template`	Támogatott	Nem támogatott	Nem támogatott	Nem támogatott	Nem támogatott	Nem támogatott	Nem támogatott
Válaszgombok`button`	Támogatott	Nem támogatott	Nem támogatott	Támogatott	Támogatott	Támogatott	Támogatott
Lista`list`	Támogatott	Nem támogatott	Nem támogatott	Nem támogatott	Nem támogatott	Nem támogatott	Nem támogatott
URL-gomb`cta_url`	Támogatott	Nem támogatott	Nem támogatott	Nem támogatott	Nem támogatott	Nem támogatott	Nem támogatott
Helyadat`location`	Támogatott	Nem támogatott	Nem támogatott	Támogatott	Nem támogatott	Nem támogatott	Nem támogatott
Névjegyek`contacts`	Támogatott	Nem támogatott	Nem támogatott	Támogatott	Nem támogatott	Nem támogatott	Nem támogatott
Szavazás`poll`	Nem támogatott	Nem támogatott	Nem támogatott	Támogatott	Nem támogatott	Nem támogatott	Nem támogatott

type: "text"

Szöveg

Egyszerű szöveg, amelyet minden csatornatípus fogad. Állítsa be a preview_url mezőt, ha azt szeretné, hogy a csatorna megjelenítse a hivatkozás előnézetét.

body: 1–4096 karakter.

WhatsApp Business
SMS
SMS OTP
Telegram
Messenger
Instagram
TikTok

POST /v1/messages

{
  "channel": "ch_7Hq2mN5vB8cX1zL0pK3j",
  "to": "+971501234567",
  "type": "text",
  "text": {
    "body": "#1042 számú rendelését feladtuk. Itt követheti: https://example.com/t/1042",
    "preview_url": true
  },
  "reference": "order-1042"
}

type: "attachments"

Mellékletek

Üzenetenként egy médiaelem, amelyre https URL hivatkozik: kép, videó, dokumentum, hang, hangüzenet vagy matrica, nem kötelező képaláírással.

Pontosan egy elem. caption: legfeljebb 1024 karakter.

WhatsApp Business
SMS
Telegram
Messenger
Instagram
TikTok

POST /v1/messages

{
  "channel": "ch_7Hq2mN5vB8cX1zL0pK3j",
  "to": "+971501234567",
  "type": "attachments",
  "attachments": [
    {
      "type": "image",
      "url": "https://example.com/receipts/1042.jpg",
      "caption": "A #1042 számú rendelés nyugtája."
    }
  ]
}

type: "template"

Sablon

Jóváhagyott WhatsApp-sablon változókkal. A 24 órás ügyfélszolgálati időablakon kívül a WhatsApp kizárólag sablonüzeneteket fogad el.

A name és a language értékének egyeznie kell a csatorna egy jóváhagyott sablonjával.

WhatsApp Business

POST /v1/messages

{
  "channel": "ch_7Hq2mN5vB8cX1zL0pK3j",
  "to": "+971501234567",
  "type": "template",
  "template": {
    "name": "order_out_for_delivery",
    "language": {
      "code": "en"
    },
    "components": [
      {
        "type": "body",
        "parameters": [
          {
            "type": "text",
            "text": "Anna"
          },
          {
            "type": "text",
            "text": "#1042"
          },
          {
            "type": "text",
            "text": "18:00"
          }
        ]
      }
    ]
  }
}

type: "button"

Válaszgombok

Üzenet legfeljebb három gyorsválasszal. A megérintett gomb azonosítója egy message.received eseményben érkezik vissza a webhookjára.

1–3 gomb. title: legfeljebb 20 karakter.

WhatsApp Business
Telegram
Messenger
Instagram
TikTok

POST /v1/messages

{
  "channel": "ch_7Hq2mN5vB8cX1zL0pK3j",
  "to": "+971501234567",
  "type": "button",
  "button": {
    "body": {
      "text": "Kétszemélyes asztalát ma estére, 19:30-ra lefoglaltuk. Számíthatunk Önre?"
    },
    "action": {
      "buttons": [
        {
          "reply": {
            "id": "confirm",
            "title": "Megerősítem"
          }
        },
        {
          "reply": {
            "id": "reschedule",
            "title": "Új időpontot kérek"
          }
        },
        {
          "reply": {
            "id": "cancel",
            "title": "Lemondom"
          }
        }
      ]
    }
  }
}

type: "list"

Lista

Egyetlen gombbal megnyitható menü, amelynek sorai címmel ellátott szakaszokba vannak rendezve.

action.button: legfeljebb 20 karakter.

WhatsApp Business

POST /v1/messages

{
  "channel": "ch_7Hq2mN5vB8cX1zL0pK3j",
  "to": "+971501234567",
  "type": "list",
  "list": {
    "body": {
      "text": "Melyik csapatunk segíthet ma Önnek?"
    },
    "action": {
      "button": "Csapat kiválasztása",
      "sections": [
        {
          "title": "Csapatok",
          "rows": [
            {
              "id": "orders",
              "title": "Rendelések",
              "description": "Kiszállítás, visszaküldés és visszatérítés"
            },
            {
              "id": "billing",
              "title": "Számlázás",
              "description": "Számlák és fizetési módok"
            },
            {
              "id": "technical",
              "title": "Technikai támogatás",
              "description": "Beállítás és hibaelhárítás"
            }
          ]
        }
      ]
    }
  }
}

type: "cta_url"

URL-gomb

Üzenet egyetlen, URL-t megnyitó gombbal: csomagkövető oldalakhoz, fizetéshez és bejelentkezési hivatkozásokhoz.

Üzenetenként egy gomb.

WhatsApp Business

POST /v1/messages

{
  "channel": "ch_7Hq2mN5vB8cX1zL0pK3j",
  "to": "+971501234567",
  "type": "cta_url",
  "cta_url": {
    "body": {
      "text": "Csomagja úton van. Kövesse valós időben!"
    },
    "action": {
      "parameters": {
        "display_text": "Rendelés követése",
        "url": "https://example.com/t/1042"
      }
    }
  }
}

type: "location"

Helyadat

Névvel és címmel ellátott térképjelölő, amely a címzett térképalkalmazásában nyílik meg.

A latitude és a longitude értéke tizedes fokban adandó meg.

WhatsApp Business
Telegram

POST /v1/messages

{
  "channel": "ch_7Hq2mN5vB8cX1zL0pK3j",
  "to": "+971501234567",
  "type": "location",
  "location": {
    "latitude": 25.2048,
    "longitude": 55.2708,
    "name": "Átvevőpont",
    "address": "Sheikh Zayed Road, Dubaj"
  }
}

type: "contacts"

Névjegyek

Egy vagy több névjegykártya. A tömböt változtatás nélkül továbbítjuk a csatornának, ezért a szolgáltató saját névjegyformátumát követi.

A példa a WhatsApp névjegyformátumát mutatja.

WhatsApp Business
Telegram

POST /v1/messages

{
  "channel": "ch_7Hq2mN5vB8cX1zL0pK3j",
  "to": "+971501234567",
  "type": "contacts",
  "contacts": [
    {
      "name": {
        "formatted_name": "Ügyfélszolgálat",
        "first_name": "Ügyfélszolgálat"
      },
      "phones": [
        {
          "phone": "+971800123456",
          "type": "WORK"
        }
      ]
    }
  ]
}

type: "poll"

Szavazás

Natív Telegram-szavazás egy kérdéssel és válaszlehetőségekkel.

Csak Telegramon.

POST /v1/messages

{
  "channel": "ch_4Tn8rW2yK6dF9sA1mQ5v",
  "to": "584201337",
  "type": "poll",
  "poll": {
    "question": "Mikor szállítsuk ki a rendelését?",
    "options": [
      "Délelőtt, 09:00–12:00",
      "Délután, 12:00–17:00",
      "Este, 17:00–21:00"
    ]
  }
}

Próbáljon ki minden típust a sandboxban

Minden fiókhoz csatornatípusonként tartozik egy sandbox csatorna. Tesztkulccsal bármelyik támogatott típust elküldheti rajta; semmit sem kézbesítünk, és semmit sem számlázunk.

API-kulcs igénylése Dokumentáció megnyitása