Vrste poruka

Devet vrsta poruka, jedno tijelo zahtjeva

Zahtjev za slanje navodi kanal, primatelja i vrstu, a sadržaj se nalazi pod ključem nazvanim po toj vrsti. Ova stranica prikazuje svaku vrstu, tijelo zahtjeva koje je stvara i kanale na kojima je podržana.

Otvorite API referencu Usporedite kanale

Matrica podrške

Koji kanal prihvaća koju vrstu

Kanal u polju capabilities navodi što prihvaća. Slanje vrste koju kanal ne podržava vraća 400 unsupported_message_type i ništa se ne naplaćuje.

Podrška za vrste poruka po vrsti kanala
Vrsta	WhatsApp	SMS	SMS OTP	Telegram	Messenger	Instagram	TikTok
Tekst`text`	Podržano	Podržano	Podržano	Podržano	Podržano	Podržano	Podržano
Privici`attachments`	Podržano	Podržano	Nije podržano	Podržano	Podržano	Podržano	Podržano
Predložak`template`	Podržano	Nije podržano	Nije podržano	Nije podržano	Nije podržano	Nije podržano	Nije podržano
Gumbi za odgovor`button`	Podržano	Nije podržano	Nije podržano	Podržano	Podržano	Podržano	Podržano
Popis`list`	Podržano	Nije podržano	Nije podržano	Nije podržano	Nije podržano	Nije podržano	Nije podržano
URL gumb`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 koji prihvaća svaka vrsta kanala. Postavite preview_url kako bi kanal prikazao pregled poveznice.

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 narudžba #1042 je poslana. Pratite je na https://example.com/t/1042",
    "preview_url": true
  },
  "reference": "order-1042"
}

type: "attachments"

Privici

Jedna medijska stavka po poruci, navedena putem https URL-a: slika, videozapis, dokument, zvučni zapis, glasovna poruka ili naljepnica, uz neobavezan opis.

Toč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 narudžbu #1042."
    }
  ]
}

type: "template"

Predložak

Odobreni WhatsApp predložak s varijablama. Predlošci su jedine poruke koje WhatsApp prihvaća izvan 24-satnog prozora korisničke podrške.

name i language moraju odgovarati odobrenom predlošku 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": "Ana"
          },
          {
            "type": "text",
            "text": "#1042"
          },
          {
            "type": "text",
            "text": "18:00"
          }
        ]
      }
    ]
  }
}

type: "button"

Gumbi za odgovor

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

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

WhatsApp Business
Telegram
Messenger
Instagram
TikTok

POST /v1/messages

{
  "channel": "ch_7Hq2mN5vB8cX1zL0pK3j",
  "to": "+971501234567",
  "type": "button",
  "button": {
    "body": {
      "text": "Vaš stol za dvoje rezerviran je večeras u 19:30. Vrijedi li dogovor i dalje?"
    },
    "action": {
      "buttons": [
        {
          "reply": {
            "id": "confirm",
            "title": "Potvrdi"
          }
        },
        {
          "reply": {
            "id": "reschedule",
            "title": "Promijeni termin"
          }
        },
        {
          "reply": {
            "id": "cancel",
            "title": "Otkaži rezervaciju"
          }
        }
      ]
    }
  }
}

type: "list"

Popis

Izbornik koji se otvara jednim gumbom, s retcima grupiranima u naslovljene odjeljke.

action.button: do 20 znakova.

WhatsApp Business

POST /v1/messages

{
  "channel": "ch_7Hq2mN5vB8cX1zL0pK3j",
  "to": "+971501234567",
  "type": "list",
  "list": {
    "body": {
      "text": "Koji vam tim danas može pomoći?"
    },
    "action": {
      "button": "Odaberite tim",
      "sections": [
        {
          "title": "Timovi",
          "rows": [
            {
              "id": "orders",
              "title": "Narudžbe",
              "description": "Dostava, povrati robe i povrati novca"
            },
            {
              "id": "billing",
              "title": "Naplata",
              "description": "Računi i načini plaćanja"
            },
            {
              "id": "technical",
              "title": "Tehnička podrška",
              "description": "Postavljanje i rješavanje problema"
            }
          ]
        }
      ]
    }
  }
}

type: "cta_url"

URL gumb

Poruka s jednim gumbom koji otvara URL, za stranice za praćenje, plaćanja i poveznice za prijavu.

Jedan gumb po poruci.

WhatsApp Business

POST /v1/messages

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

type: "location"

Lokacija

Oznaka na karti s nazivom i adresom koja se otvara u primateljevoj aplikaciji za karte.

latitude i longitude izraženi su u decimalnim stupnjevima.

WhatsApp Business
Telegram

POST /v1/messages

{
  "channel": "ch_7Hq2mN5vB8cX1zL0pK3j",
  "to": "+971501234567",
  "type": "location",
  "location": {
    "latitude": 25.2048,
    "longitude": 55.2708,
    "name": "Mjesto preuzimanja",
    "address": "Sheikh Zayed Road, Dubai"
  }
}

type: "contacts"

Kontakti

Jedna ili više kartica kontakata. Niz se kanalu prosljeđuje onakav kakav jest, pa koristi format kontakata samog pružatelja usluge.

Primjer prikazuje WhatsAppov format kontakta.

WhatsApp Business
Telegram

POST /v1/messages

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

type: "poll"

Anketa

Izvorna Telegram anketa s pitanjem i ponuđenim odgovorima.

Samo Telegram.

POST /v1/messages

{
  "channel": "ch_4Tn8rW2yK6dF9sA1mQ5v",
  "to": "584201337",
  "type": "poll",
  "poll": {
    "question": "Kada da vam dostavimo narudžbu?",
    "options": [
      "Ujutro, od 09:00 do 12:00",
      "Poslijepodne, od 12:00 do 17:00",
      "Navečer, od 17:00 do 21:00"
    ]
  }
}

Isprobajte svaku vrstu u sandboxu

Svaki račun ima sandbox kanal za svaku vrstu kanala. Testnim ključem pošaljite bilo koju vrstu koju kanal podržava: ništa se ne isporučuje i ništa se ne naplaćuje.

Nabavite API ključ Pročitajte dokumentaciju