Typy wiadomości

Dziewięć typów wiadomości, jedna treść żądania

Żądanie wysyłki wskazuje kanał, odbiorcę i typ, a treść znajduje się pod kluczem o nazwie tego typu. Na tej stronie zobaczysz każdy typ, treść żądania, która go tworzy, oraz kanały, w których jest obsługiwany.

Otwórz opis API Porównaj kanały

Tabela obsługi

Który kanał przyjmuje który typ

Kanał podaje w polu capabilities, co przyjmuje. Wysłanie typu, którego kanał nie obsługuje, zwraca 400 unsupported_message_type i nie powoduje naliczenia opłaty.

Obsługa typów wiadomości według typu kanału
Typ	WhatsApp	SMS	SMS OTP	Telegram	Messenger	Instagram	TikTok
Tekst`text`	Obsługiwany	Obsługiwany	Obsługiwany	Obsługiwany	Obsługiwany	Obsługiwany	Obsługiwany
Załączniki`attachments`	Obsługiwany	Obsługiwany	Nieobsługiwany	Obsługiwany	Obsługiwany	Obsługiwany	Obsługiwany
Szablon`template`	Obsługiwany	Nieobsługiwany	Nieobsługiwany	Nieobsługiwany	Nieobsługiwany	Nieobsługiwany	Nieobsługiwany
Przyciski odpowiedzi`button`	Obsługiwany	Nieobsługiwany	Nieobsługiwany	Obsługiwany	Obsługiwany	Obsługiwany	Obsługiwany
Lista`list`	Obsługiwany	Nieobsługiwany	Nieobsługiwany	Nieobsługiwany	Nieobsługiwany	Nieobsługiwany	Nieobsługiwany
Przycisk URL`cta_url`	Obsługiwany	Nieobsługiwany	Nieobsługiwany	Nieobsługiwany	Nieobsługiwany	Nieobsługiwany	Nieobsługiwany
Lokalizacja`location`	Obsługiwany	Nieobsługiwany	Nieobsługiwany	Obsługiwany	Nieobsługiwany	Nieobsługiwany	Nieobsługiwany
Kontakty`contacts`	Obsługiwany	Nieobsługiwany	Nieobsługiwany	Obsługiwany	Nieobsługiwany	Nieobsługiwany	Nieobsługiwany
Ankieta`poll`	Nieobsługiwany	Nieobsługiwany	Nieobsługiwany	Obsługiwany	Nieobsługiwany	Nieobsługiwany	Nieobsługiwany

type: "text"

Tekst

Zwykły tekst, przyjmowany przez każdy typ kanału. Ustaw preview_url, aby kanał wyświetlił podgląd linku.

body: od 1 do 4096 znaków.

WhatsApp Business
SMS
SMS OTP
Telegram
Messenger
Instagram
TikTok

POST /v1/messages

{
  "channel": "ch_7Hq2mN5vB8cX1zL0pK3j",
  "to": "+971501234567",
  "type": "text",
  "text": {
    "body": "Twoje zamówienie nr 1042 zostało wysłane. Śledź przesyłkę: https://example.com/t/1042",
    "preview_url": true
  },
  "reference": "order-1042"
}

type: "attachments"

Załączniki

Jeden element multimedialny na wiadomość, wskazany adresem URL https: obraz, wideo, dokument, plik audio, wiadomość głosowa lub naklejka, z opcjonalnym podpisem.

Dokładnie jeden element. caption: do 1024 znaków.

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": "Paragon do zamówienia nr 1042."
    }
  ]
}

type: "template"

Szablon

Zatwierdzony szablon WhatsApp ze zmiennymi. Szablony to jedyne wiadomości, które WhatsApp przyjmuje poza 24-godzinnym oknem obsługi klienta.

name i language muszą odpowiadać zatwierdzonemu szablonowi kanału.

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

type: "button"

Przyciski odpowiedzi

Wiadomość z maksymalnie trzema szybkimi odpowiedziami. Identyfikator klikniętego przycisku wraca na Twój webhook w zdarzeniu message.received.

Od 1 do 3 przycisków. title: do 20 znaków.

WhatsApp Business
Telegram
Messenger
Instagram
TikTok

POST /v1/messages

{
  "channel": "ch_7Hq2mN5vB8cX1zL0pK3j",
  "to": "+971501234567",
  "type": "button",
  "button": {
    "body": {
      "text": "Stolik dla dwóch osób jest zarezerwowany na dziś na 19:30. Czy rezerwacja jest aktualna?"
    },
    "action": {
      "buttons": [
        {
          "reply": {
            "id": "confirm",
            "title": "Potwierdź"
          }
        },
        {
          "reply": {
            "id": "reschedule",
            "title": "Zmień termin"
          }
        },
        {
          "reply": {
            "id": "cancel",
            "title": "Anuluj rezerwację"
          }
        }
      ]
    }
  }
}

type: "list"

Lista

Menu otwierane jednym przyciskiem, z wierszami pogrupowanymi w sekcje z tytułami.

action.button: do 20 znaków.

WhatsApp Business

POST /v1/messages

{
  "channel": "ch_7Hq2mN5vB8cX1zL0pK3j",
  "to": "+971501234567",
  "type": "list",
  "list": {
    "body": {
      "text": "Który zespół może Ci dziś pomóc?"
    },
    "action": {
      "button": "Wybierz zespół",
      "sections": [
        {
          "title": "Zespoły",
          "rows": [
            {
              "id": "orders",
              "title": "Zamówienia",
              "description": "Dostawa, zwroty i reklamacje"
            },
            {
              "id": "billing",
              "title": "Rozliczenia",
              "description": "Faktury i metody płatności"
            },
            {
              "id": "technical",
              "title": "Wsparcie techniczne",
              "description": "Konfiguracja i rozwiązywanie problemów"
            }
          ]
        }
      ]
    }
  }
}

type: "cta_url"

Przycisk URL

Wiadomość z jednym przyciskiem otwierającym adres URL – do stron śledzenia przesyłek, płatności i linków logowania.

Jeden przycisk na wiadomość.

WhatsApp Business

POST /v1/messages

{
  "channel": "ch_7Hq2mN5vB8cX1zL0pK3j",
  "to": "+971501234567",
  "type": "cta_url",
  "cta_url": {
    "body": {
      "text": "Twoja paczka jest już w drodze. Śledź ją na bieżąco."
    },
    "action": {
      "parameters": {
        "display_text": "Śledź zamówienie",
        "url": "https://example.com/t/1042"
      }
    }
  }
}

type: "location"

Lokalizacja

Pinezka z nazwą i adresem, która otwiera się w aplikacji z mapami odbiorcy.

latitude i longitude to stopnie dziesiętne.

WhatsApp Business
Telegram

POST /v1/messages

{
  "channel": "ch_7Hq2mN5vB8cX1zL0pK3j",
  "to": "+971501234567",
  "type": "location",
  "location": {
    "latitude": 25.2048,
    "longitude": 55.2708,
    "name": "Punkt odbioru",
    "address": "ul. Marszałkowska 10, Warszawa"
  }
}

type: "contacts"

Kontakty

Jedna lub więcej wizytówek kontaktowych. Tablica jest przekazywana do kanału bez zmian, więc ma format kontaktu właściwy dla dostawcy.

Przykład pokazuje format kontaktu WhatsApp.

WhatsApp Business
Telegram

POST /v1/messages

{
  "channel": "ch_7Hq2mN5vB8cX1zL0pK3j",
  "to": "+971501234567",
  "type": "contacts",
  "contacts": [
    {
      "name": {
        "formatted_name": "Dział wsparcia",
        "first_name": "Wsparcie"
      },
      "phones": [
        {
          "phone": "+971800123456",
          "type": "WORK"
        }
      ]
    }
  ]
}

type: "poll"

Ankieta

Natywna ankieta Telegrama z pytaniem i zestawem odpowiedzi.

Tylko Telegram.

POST /v1/messages

{
  "channel": "ch_4Tn8rW2yK6dF9sA1mQ5v",
  "to": "584201337",
  "type": "poll",
  "poll": {
    "question": "Kiedy mamy dostarczyć Twoje zamówienie?",
    "options": [
      "Rano, 09:00–12:00",
      "Po południu, 12:00–17:00",
      "Wieczorem, 17:00–21:00"
    ]
  }
}

Wypróbuj każdy typ w sandboksie

Każde konto ma kanał sandbox dla każdego typu kanału. Wyślij kluczem testowym dowolny obsługiwany typ – nic nie zostanie dostarczone ani naliczone.

Odbierz klucz API Zobacz dokumentację