Zapier Integration

Στο παρόν άρθρο μπορείτε να βρείτε και να ακολουθήσετε τις οδηγίες για να ενσωματώσετε το mMP σε οποιαδήποτε πλατφόρμα της επιλογής σας μέσω του εργαλείου Zapier.

 

Λήψη SMS και Viber μηνυμάτων   #

 

Για να μπορέσετε να λαμβάνετε τα μηνύματα τα οποία αποστέλλονται στον mMP λογαριασμό σας, μέσω Zapier, θα χρειαστεί να  χρησιμοποιήσετε ως component το app Webhooks by Zapier.

 

Ρυθμίσεις (εικόνα 1):

 

  1. Επιλέγετε το επιθυμητό και αναγκαίο app Webhooks by Zapier”.
  2. Στο πεδίο “Event” επιλέγετε την επιλογή Catch Raw Hook”.
  3. Κάντε κλικ στο κουμπί “Continue”.

 

Εικόνα 1

 

Στο επόμενο βήμα (εικόνα 2), το zapier δημιουργεί το webhook URL της υπηρεσίας. Το συγκεκριμένο URL θα χρειατεί να κοινοποιηθεί στη modulus, στο telecoms@modulus.gr μαζί με τα στοιχεία του email το οποίο έχει χρησιμοποιηθεί για τη δημιουργία του mMP λογαριασμού σας ώστε να ενσωματωθεί στις υπηρεσίες της πλατφόρμας.

 

Εικόνα 2

Ενσωματώνοντας  το URL στην υπηρεσία, με κάθε νέα λήψη μηνύματος θα δημιουργείται αντίστοιχα μία εγγραφή (record) όπως φαίνεται στην εικόνα 3 παρακάτω.

 

Εικόνα 3

Οι μεταβλητές σε κάθε εγγραφή που δημιουργείται, είναι οι παρακάτω:

 

Variable name Information
querystring__type Message type (SMS / Viber)
Querystring__sender Τηλέφωνο αποστολέα
querystring__receiver Τηλέφωνο παραλήπτη
querystring__text Κείμενο μηνύματος
querystring__id ID μηνύματος πλατφόρμας
querystring__foreign_id ID μηνύματος παρόχου
querystring__reply_datetime_stamp Ημερομηνία λήψης μηνύματος
querystring__media Αρχείο μηνύματος (Viber Attachment)
querystring__filename Όνομα αρχείου μηνύματος (Viber Attachment)

 

Επιλέγοντας ένα συγκεκριμένο record (εγγραφή) και κάνοντας κλικ στο κουμπί «Continue with selected record» (όπως φαίνεται στην εικόνα 3), μπορείτε να μεταφέρετε την πληροφορία του εισερχόμενου μηνύματος στο flow που επιθυμείτε.

 

Αποστολή SMS και Viber Μηνυμάτων #

 

Για να μπορέσετε να στείλετε μηνύματα μέσω Zapier, θα χρειαστεί να  χρησιμοποιήσετε ως component το app Webhooks by Zapier.

 

Ρυθμίσεις (εικόνα 4):

 

  1. Επιλέγετε το επιθυμητό και αναγκαίο app Webhooks by Zapier”.
  2. Στο πεδίο “Event” επιλέγετε την επιλογή Custom Request”.
  3. Κάντε κλικ στο κουμπί “Continue”.

 

Εικόνα 4

Αφού προχωρήσετε, το επόμενο βήμα αφορά την παραμετροποίηση του “Webhook” και συγκεκριμένα την ενότητα “Action”.  όπως φαίνεται στην εικόνα 5.

 

Εικόνα 5

Πιο συγκεκριμένα, για την ορθή συμπλήρωση των πεδίων μέσα στην ενότητα «Action», μπορείτε να ανατρέξετε στον πίνακα που ακολουθεί:

 

Πεδίο Τιμή
Method POST
URL https://messaging.modulus.gr/ott-api/message
Data*

(αφορά το API)

{

  “routing”: “string”,

  “priority”: 3,

  “recipients”: [

    {

      “msisdn”: “string”

    }

  ],

  “viber”: {

    “sender”: “string”,

    “type”: “text”,

    “validityPeriod”: 86400,

    “text”: “string”,

    “imageUrl”: “string”,

    “buttonCaption”: “string”,

    “buttonAction”: “string”,

    “expiryText”: “string”,

    “scheduleDateTime”: “2022-03-10T16:15:50Z”

  },

  “sms”: {

    “sender”: “string”,

    “text”: “string”,

    “encoding”: “gsm”,

    “validityPeriod”: 86400,

    “scheduleDateTime”: “2022-03-10T16:15:50Z”,

    “dcs”: “string”,

    “udh”: “string”

  },

  “dlr”: true,

  “dlrUrl”: “string”,

  “externalTags”: [

    “string”

  ]

}

Unflatten YES
Basic Auth Bearer <your API key>
Headers Content-Type: application/json

 

*  Σημείωση 1: Η πλήρης επεξήγηση του παρεχόμενου API είναι διαθέσιμη στον σύνδεσμο https://messaging.modulus.gr/ott-api/swagger .

 

*  Σημείωση 2: Στο πεδίο Data, γίνεται η παραμετροποίηση των μηνυμάτων και αποστολή των δυναμικών πληροφοριών. Με την ολοκλήρωση των παραπάνω, η αποστολή μηνυμάτων μπορεί να ενσωματωθεί στο flow της υπηρεσίας.