Μετάβαση στο περιεχόμενο
OmniMessage

Τύποι μηνυμάτων

Εννέα τύποι μηνυμάτων, ένα σώμα αιτήματος

Ένα αίτημα αποστολής ορίζει ένα κανάλι, έναν παραλήπτη και έναν τύπο, με το περιεχόμενο κάτω από ένα κλειδί που έχει το όνομα του τύπου. Αυτή η σελίδα παρουσιάζει κάθε τύπο, το σώμα που τον παράγει και πού υποστηρίζεται.

Άνοιγμα της αναφοράς APIΣύγκριση καναλιών

Πίνακας υποστήριξης

Ποιο κανάλι δέχεται ποιον τύπο

Κάθε κανάλι δηλώνει τι δέχεται στο capabilities. Η αποστολή τύπου που δεν υποστηρίζει το κανάλι επιστρέφει 400 unsupported_message_type και δεν γίνεται καμία χρέωση.

Υποστήριξη τύπων μηνυμάτων ανά τύπο καναλιού
ΤύποςWhatsAppSMSSMS OTPTelegramMessengerInstagramTikTok
ΚείμενοtextΥποστηρίζεταιΥποστηρίζεταιΥποστηρίζεταιΥποστηρίζεταιΥποστηρίζεταιΥποστηρίζεταιΥποστηρίζεται
ΣυνημμέναattachmentsΥποστηρίζεταιΥποστηρίζεταιΔεν υποστηρίζεταιΥποστηρίζεταιΥποστηρίζεταιΥποστηρίζεταιΥποστηρίζεται
ΠρότυποtemplateΥποστηρίζεταιΔεν υποστηρίζεταιΔεν υποστηρίζεταιΔεν υποστηρίζεταιΔεν υποστηρίζεταιΔεν υποστηρίζεταιΔεν υποστηρίζεται
Κουμπιά απάντησηςbuttonΥποστηρίζεταιΔεν υποστηρίζεταιΔεν υποστηρίζεταιΥποστηρίζεταιΥποστηρίζεταιΥποστηρίζεταιΥποστηρίζεται
ΛίσταlistΥποστηρίζεταιΔεν υποστηρίζεταιΔεν υποστηρίζεταιΔεν υποστηρίζεταιΔεν υποστηρίζεταιΔεν υποστηρίζεταιΔεν υποστηρίζεται
Κουμπί URLcta_urlΥποστηρίζεταιΔεν υποστηρίζεταιΔεν υποστηρίζεταιΔεν υποστηρίζεταιΔεν υποστηρίζεταιΔεν υποστηρίζεταιΔεν υποστηρίζεται
ΤοποθεσίαlocationΥποστηρίζεταιΔεν υποστηρίζεταιΔεν υποστηρίζεταιΥποστηρίζεταιΔεν υποστηρίζεταιΔεν υποστηρίζεταιΔεν υποστηρίζεται
ΕπαφέςcontactsΥποστηρίζεταιΔεν υποστηρίζεταιΔεν υποστηρίζεταιΥποστηρίζεταιΔεν υποστηρίζεταιΔεν υποστηρίζεταιΔεν υποστηρίζεται
ΔημοσκόπησηpollΔεν υποστηρίζεταιΔεν υποστηρίζεταιΔεν υποστηρίζεταιΥποστηρίζεταιΔεν υποστηρίζεταιΔεν υποστηρίζεταιΔεν υποστηρίζεται
type: "text"

Κείμενο

Απλό κείμενο, αποδεκτό από κάθε τύπο καναλιού. Ορίστε το preview_url για να εμφανίσει το κανάλι προεπισκόπηση συνδέσμου.

body: 1 έως 4.096 χαρακτήρες.

  • WhatsApp Business
  • SMS
  • SMS OTP
  • Telegram
  • Messenger
  • Instagram
  • TikTok
POST /v1/messages
{
  "channel": "ch_7Hq2mN5vB8cX1zL0pK3j",
  "to": "+971501234567",
  "type": "text",
  "text": {
    "body": "Η παραγγελία σας #1042 έχει αποσταλεί. Παρακολουθήστε τη στο https://example.com/t/1042",
    "preview_url": true
  },
  "reference": "order-1042"
}
type: "attachments"

Συνημμένα

Ένα στοιχείο πολυμέσων ανά μήνυμα, με αναφορά σε URL https: εικόνα, βίντεο, έγγραφο, ήχος, φωνητικό μήνυμα ή αυτοκόλλητο, με προαιρετική λεζάντα.

Ακριβώς ένα στοιχείο. caption: έως 1.024 χαρακτήρες.

  • 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": "Η απόδειξή σας για την παραγγελία #1042."
    }
  ]
}
type: "template"

Πρότυπο

Ένα εγκεκριμένο πρότυπο WhatsApp με μεταβλητές. Τα πρότυπα είναι τα μόνα μηνύματα που δέχεται το WhatsApp εκτός του 24ωρου παραθύρου εξυπηρέτησης πελατών.

Τα name και language πρέπει να αντιστοιχούν σε εγκεκριμένο πρότυπο του καναλιού.

  • 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": "Ελένη"
          },
          {
            "type": "text",
            "text": "#1042"
          },
          {
            "type": "text",
            "text": "18:00"
          }
        ]
      }
    ]
  }
}
type: "button"

Κουμπιά απάντησης

Ένα μήνυμα με έως τρεις γρήγορες απαντήσεις. Το αναγνωριστικό του κουμπιού που πατήθηκε επιστρέφει στο webhook σας σε ένα συμβάν message.received.

1 έως 3 κουμπιά. title: έως 20 χαρακτήρες.

  • WhatsApp Business
  • Telegram
  • Messenger
  • Instagram
  • TikTok
POST /v1/messages
{
  "channel": "ch_7Hq2mN5vB8cX1zL0pK3j",
  "to": "+971501234567",
  "type": "button",
  "button": {
    "body": {
      "text": "Το τραπέζι σας για δύο άτομα έχει κρατηθεί για απόψε στις 19:30. Ισχύει ακόμη η κράτησή σας;"
    },
    "action": {
      "buttons": [
        {
          "reply": {
            "id": "confirm",
            "title": "Επιβεβαίωση"
          }
        },
        {
          "reply": {
            "id": "reschedule",
            "title": "Αλλαγή ώρας"
          }
        },
        {
          "reply": {
            "id": "cancel",
            "title": "Ακύρωση κράτησης"
          }
        }
      ]
    }
  }
}
type: "list"

Λίστα

Ένα μενού που ανοίγει από ένα μόνο κουμπί, με γραμμές ομαδοποιημένες σε ενότητες με τίτλο.

action.button: έως 20 χαρακτήρες.

  • WhatsApp Business
POST /v1/messages
{
  "channel": "ch_7Hq2mN5vB8cX1zL0pK3j",
  "to": "+971501234567",
  "type": "list",
  "list": {
    "body": {
      "text": "Ποια ομάδα μπορεί να σας βοηθήσει σήμερα;"
    },
    "action": {
      "button": "Επιλέξτε ομάδα",
      "sections": [
        {
          "title": "Ομάδες",
          "rows": [
            {
              "id": "orders",
              "title": "Παραγγελίες",
              "description": "Παράδοση, επιστροφές προϊόντων και χρημάτων"
            },
            {
              "id": "billing",
              "title": "Χρεώσεις",
              "description": "Τιμολόγια και τρόποι πληρωμής"
            },
            {
              "id": "technical",
              "title": "Τεχνική υποστήριξη",
              "description": "Ρύθμιση και αντιμετώπιση προβλημάτων"
            }
          ]
        }
      ]
    }
  }
}
type: "cta_url"

Κουμπί URL

Ένα μήνυμα με ένα κουμπί που ανοίγει ένα URL, για σελίδες παρακολούθησης, πληρωμές και συνδέσμους εισόδου.

Ένα κουμπί ανά μήνυμα.

  • WhatsApp Business
POST /v1/messages
{
  "channel": "ch_7Hq2mN5vB8cX1zL0pK3j",
  "to": "+971501234567",
  "type": "cta_url",
  "cta_url": {
    "body": {
      "text": "Το δέμα σας είναι καθ’ οδόν. Παρακολουθήστε το σε πραγματικό χρόνο."
    },
    "action": {
      "parameters": {
        "display_text": "Εντοπισμός δέματος",
        "url": "https://example.com/t/1042"
      }
    }
  }
}
type: "location"

Τοποθεσία

Μια πινέζα με όνομα και διεύθυνση, που ανοίγει στην εφαρμογή χαρτών του παραλήπτη.

Τα latitude και longitude δίνονται σε δεκαδικές μοίρες.

  • WhatsApp Business
  • Telegram
POST /v1/messages
{
  "channel": "ch_7Hq2mN5vB8cX1zL0pK3j",
  "to": "+971501234567",
  "type": "location",
  "location": {
    "latitude": 25.2048,
    "longitude": 55.2708,
    "name": "Σημείο παραλαβής",
    "address": "Sheikh Zayed Road, Ντουμπάι"
  }
}
type: "contacts"

Επαφές

Μία ή περισσότερες κάρτες επαφών. Ο πίνακας προωθείται στο κανάλι ως έχει, επομένως ακολουθεί τη μορφή επαφών του ίδιου του παρόχου.

Το παράδειγμα δείχνει τη μορφή επαφών του WhatsApp.

  • WhatsApp Business
  • Telegram
POST /v1/messages
{
  "channel": "ch_7Hq2mN5vB8cX1zL0pK3j",
  "to": "+971501234567",
  "type": "contacts",
  "contacts": [
    {
      "name": {
        "formatted_name": "Τμήμα υποστήριξης",
        "first_name": "Υποστήριξη"
      },
      "phones": [
        {
          "phone": "+971800123456",
          "type": "WORK"
        }
      ]
    }
  ]
}
type: "poll"

Δημοσκόπηση

Μια εγγενής δημοσκόπηση του Telegram με μια ερώτηση και ένα σύνολο επιλογών.

Μόνο στο Telegram.

  • Telegram
POST /v1/messages
{
  "channel": "ch_4Tn8rW2yK6dF9sA1mQ5v",
  "to": "584201337",
  "type": "poll",
  "poll": {
    "question": "Πότε να παραδώσουμε την παραγγελία σας;",
    "options": [
      "Πρωί, 09:00 έως 12:00",
      "Απόγευμα, 12:00 έως 17:00",
      "Βράδυ, 17:00 έως 21:00"
    ]
  }
}

Δοκιμάστε κάθε τύπο στο sandbox

Κάθε λογαριασμός διαθέτει ένα κανάλι sandbox για κάθε τύπο καναλιού. Στείλτε με δοκιμαστικό κλειδί οποιονδήποτε τύπο υποστηρίζει και τίποτα δεν θα παραδοθεί ούτε θα χρεωθεί.

Αποκτήστε κλειδί APIΔιαβάστε την τεκμηρίωση