Tipovi poruka

Devet tipova poruka, jedno telo zahteva

Zahtev za slanje navodi kanal, primaoca i tip, a sadržaj se nalazi pod ključem koji nosi naziv tipa. Ova stranica prikazuje svaki tip, telo zahteva koje ga proizvodi i gde je podržan.

Otvorite API referencu Uporedite kanale

Tabela podrške

Koji kanal prihvata koji tip

Kanal navodi šta prihvata u polju capabilities. Slanje tipa koji kanal ne podržava vraća 400 unsupported_message_type i ništa se ne naplaćuje.

Podrška za tipove poruka po tipu kanala
Tip	WhatsApp	SMS	SMS OTP	Telegram	Messenger	Instagram	TikTok
Tekst`text`	Podržano	Podržano	Podržano	Podržano	Podržano	Podržano	Podržano
Prilozi`attachments`	Podržano	Podržano	Nije podržano	Podržano	Podržano	Podržano	Podržano
Šablon`template`	Podržano	Nije podržano	Nije podržano	Nije podržano	Nije podržano	Nije podržano	Nije podržano
Dugmad za odgovor`button`	Podržano	Nije podržano	Nije podržano	Podržano	Podržano	Podržano	Podržano
Lista`list`	Podržano	Nije podržano	Nije podržano	Nije podržano	Nije podržano	Nije podržano	Nije podržano
URL dugme`cta_url`	Podržano	Nije podržano	Nije podržano	Nije podržano	Nije podržano	Nije podržano	Nije podržano
Lokacija`location`	Podržano	Nije podržano	Nije podržano	Podržano	Nije podržano	Nije podržano	Nije podržano
Kontakti`contacts`	Podržano	Nije podržano	Nije podržano	Podržano	Nije podržano	Nije podržano	Nije podržano
Anketa`poll`	Nije podržano	Nije podržano	Nije podržano	Podržano	Nije podržano	Nije podržano	Nije podržano

type: "text"

Tekst

Običan tekst, prihvata ga svaki tip kanala. Podesite preview_url da bi kanal prikazao pregled linka.

body: od 1 do 4.096 znakova.

WhatsApp Business
SMS
SMS OTP
Telegram
Messenger
Instagram
TikTok

POST /v1/messages

{
  "channel": "ch_7Hq2mN5vB8cX1zL0pK3j",
  "to": "+971501234567",
  "type": "text",
  "text": {
    "body": "Vaša porudžbina #1042 je poslata. Pratite je na https://example.com/t/1042",
    "preview_url": true
  },
  "reference": "order-1042"
}

type: "attachments"

Prilozi

Jedna medijska stavka po poruci, zadata https URL-om: slika, video, dokument, audio, glasovna poruka ili stiker, uz opcioni opis.

Tačno jedna stavka. caption: do 1.024 znaka.

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": "Vaš račun za porudžbinu #1042."
    }
  ]
}

type: "template"

Šablon

Odobreni WhatsApp šablon sa promenljivama. Šabloni su jedine poruke koje WhatsApp prihvata van 24-časovnog prozora korisničke podrške.

name i language moraju da odgovaraju odobrenom šablonu kanala.

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": "Milica"
          },
          {
            "type": "text",
            "text": "#1042"
          },
          {
            "type": "text",
            "text": "18:00"
          }
        ]
      }
    ]
  }
}

type: "button"

Dugmad za odgovor

Poruka sa najviše tri brza odgovora. ID dodirnutog dugmeta vraća se na vaš webhook u događaju message.received.

Od 1 do 3 dugmeta. title: do 20 znakova.

WhatsApp Business
Telegram
Messenger
Instagram
TikTok

POST /v1/messages

{
  "channel": "ch_7Hq2mN5vB8cX1zL0pK3j",
  "to": "+971501234567",
  "type": "button",
  "button": {
    "body": {
      "text": "Vaš sto za dvoje je rezervisan za večeras u 19:30. Da li i dalje možete da dođete?"
    },
    "action": {
      "buttons": [
        {
          "reply": {
            "id": "confirm",
            "title": "Potvrđujem"
          }
        },
        {
          "reply": {
            "id": "reschedule",
            "title": "Promena termina"
          }
        },
        {
          "reply": {
            "id": "cancel",
            "title": "Otkazujem"
          }
        }
      ]
    }
  }
}

type: "list"

Lista

Meni koji se otvara jednim dugmetom, sa redovima grupisanim u naslovljene odeljke.

action.button: do 20 znakova.

WhatsApp Business

POST /v1/messages

{
  "channel": "ch_7Hq2mN5vB8cX1zL0pK3j",
  "to": "+971501234567",
  "type": "list",
  "list": {
    "body": {
      "text": "Koji tim može da vam pomogne danas?"
    },
    "action": {
      "button": "Izaberite tim",
      "sections": [
        {
          "title": "Timovi",
          "rows": [
            {
              "id": "orders",
              "title": "Porudžbine",
              "description": "Dostava, povraćaj robe i refundacije"
            },
            {
              "id": "billing",
              "title": "Naplata",
              "description": "Fakture i načini plaćanja"
            },
            {
              "id": "technical",
              "title": "Tehnička podrška",
              "description": "Podešavanje i rešavanje problema"
            }
          ]
        }
      ]
    }
  }
}

type: "cta_url"

URL dugme

Poruka sa jednim dugmetom koje otvara URL, za stranice za praćenje, plaćanja i linkove za prijavu.

Jedno dugme po poruci.

WhatsApp Business

POST /v1/messages

{
  "channel": "ch_7Hq2mN5vB8cX1zL0pK3j",
  "to": "+971501234567",
  "type": "cta_url",
  "cta_url": {
    "body": {
      "text": "Vaš paket je na putu. Pratite ga u realnom vremenu."
    },
    "action": {
      "parameters": {
        "display_text": "Pratite porudžbinu",
        "url": "https://example.com/t/1042"
      }
    }
  }
}

type: "location"

Lokacija

Oznaka na mapi sa nazivom i adresom, koja se otvara u aplikaciji za mape kod primaoca.

latitude i longitude su u decimalnim stepenima.

WhatsApp Business
Telegram

POST /v1/messages

{
  "channel": "ch_7Hq2mN5vB8cX1zL0pK3j",
  "to": "+971501234567",
  "type": "location",
  "location": {
    "latitude": 25.2048,
    "longitude": 55.2708,
    "name": "Mesto preuzimanja",
    "address": "Šeik Zajed Roud, Dubai"
  }
}

type: "contacts"

Kontakti

Jedna ili više kontakt kartica. Niz se prosleđuje kanalu onakav kakav jeste, pa koristi format kontakata samog provajdera.

Primer prikazuje WhatsApp format kontakata.

WhatsApp Business
Telegram

POST /v1/messages

{
  "channel": "ch_7Hq2mN5vB8cX1zL0pK3j",
  "to": "+971501234567",
  "type": "contacts",
  "contacts": [
    {
      "name": {
        "formatted_name": "Služba podrške",
        "first_name": "Podrška"
      },
      "phones": [
        {
          "phone": "+971800123456",
          "type": "WORK"
        }
      ]
    }
  ]
}

type: "poll"

Anketa

Izvorna Telegram anketa sa pitanjem i skupom opcija.

Samo Telegram.

POST /v1/messages

{
  "channel": "ch_4Tn8rW2yK6dF9sA1mQ5v",
  "to": "584201337",
  "type": "poll",
  "poll": {
    "question": "Kada da vam isporučimo porudžbinu?",
    "options": [
      "Pre podne, 09:00–12:00",
      "Posle podne, 12:00–17:00",
      "Uveče, 17:00–21:00"
    ]
  }
}

Isprobajte svaki tip u sandboxu

Svaki nalog ima sandbox kanal za svaki tip kanala. Pošaljite testnim ključem bilo koji tip koji taj kanal podržava; ništa se ne isporučuje niti naplaćuje.

Preuzmite API ključ Pročitajte dokumentaciju