Σε αυτόν τον οδηγό θα δείτε πώς να ενσωματώσετε τo modulus Messaging Platform (mMP) με το Zapier, ώστε να αυτοματοποιήσετε την αποστολή και λήψη SMS και Viber μηνυμάτων μέσω webhooks και no-code workflows.
Η διασύνδεση επιτρέπει messaging automation, webhook integrations, inbound message processing και αποστολή transactional ή marketing μηνυμάτων μέσα από οποιαδήποτε πλατφόρμα υποστηρίζει Zapier.
Λήψη SMS και Viber μηνυμάτων
Για να μπορέσετε να λαμβάνετε τα μηνύματα που αποστέλλονται στον mMP λογαριασμό σας μέσω Zapier, θα χρειαστεί να χρησιμοποιήσετε το app “Webhooks by Zapier”.
Ρυθμίσεις (Εικόνα 1):
-
Επιλέξτε το app “Webhooks by Zapier”.
-
Στο πεδίο “Event”, επιλέξτε “Catch Raw Hook”.
-
Κάντε κλικ στο κουμπί “Continue”.
Εικόνα 1 – Ρυθμίσεις Webhooks by Zapier
Στο επόμενο βήμα (Εικόνα 2), το Zapier δημιουργεί το webhook URL της υπηρεσίας. Αυτό το URL θα χρειαστεί να κοινοποιηθεί στη modulus, στο telecoms@modulus.gr, μαζί με τα στοιχεία του email που έχει χρησιμοποιηθεί για τη δημιουργία του mMP λογαριασμού σας, ώστε να ενσωματωθεί στις υπηρεσίες της πλατφόρμας.
Εικόνα 2 – Webhook URL
Ενσωματώνοντας το 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, θα χρειαστεί να χρησιμοποιήσετε το app “Webhooks by Zapier”.
Ρυθμίσεις (Εικόνα 4):
- Επιλέξτε το app “Webhooks by Zapier”.
- Στο πεδίο “Event”, επιλέξτε “Custom Request”.
- Κάντε κλικ στο κουμπί “Continue”.
Εικόνα 4 – Ρυθμίσεις αποστολής μέσω Webhooks by Zapier
Αφού προχωρήσετε, το επόμενο βήμα αφορά την παραμετροποίηση του “Webhook” και συγκεκριμένα την ενότητα “Action”, όπως φαίνεται στην Εικόνα 5.
Εικόνα 5 – Παραμετροποίηση Webhook Action
Για την ορθή συμπλήρωση των πεδίων μέσα στην ενότητα “Action”, ανατρέξτε στον παρακάτω πίνακα:
| Πεδίο | Τιμή |
| Method | POST |
| URL | https://messaging.modulus.gr/ott-api/message |
| Unflatten | YES |
| Basic Auth | Bearer <your API key> |
| Headers | Content-Type: application/json |
Data:
{
"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"
]
}
Σημείωση: Η πλήρης τεκμηρίωση του API είναι διαθέσιμη στο Swagger API.
Στο πεδίο Data γίνεται η παραμετροποίηση των μηνυμάτων και η αποστολή των δυναμικών πληροφοριών. Με την ολοκλήρωση των παραπάνω, η αποστολή μηνυμάτων μπορεί να ενσωματωθεί στο flow της υπηρεσίας.