Ενημέρωση καμπάνιας μηνυμάτων

Διόρθωση καμπάνιας χωρίς δημιουργία νέας εγγραφής

Χρησιμοποιήστε αυτή τη διαδρομή για να τροποποιήσετε την περιγραφή, τα παραδείγματα μηνυμάτων, την επεξήγηση της συγκατάθεσης ή τα υποστηριζόμενα χαρακτηριστικά περιεχομένου μιας υπάρχουσας καμπάνιας. Διατηρήστε το αναγνωριστικό της καμπάνιας και την τρέχουσα επωνυμία και περίπτωση χρήσης της. Η νέα εγγραφή δεν αποτελεί μηχανισμό επανάληψης για τη διόρθωση υπάρχουσας καμπάνιας.

Πραγματοποιήστε έλεγχο ταυτότητας με ενεργοποιημένο λογαριασμό API μέσω HTTPS, από επιτρεπόμενη διεύθυνση IP προέλευσης. Είναι διαθέσιμη μόνο καμπάνια που ανήκει σε αυτόν τον λογαριασμό. Διαβάστε την τρέχουσα κατάστασή της πριν προετοιμάσετε αλλαγές· οι καμπάνιες που έχουν λήξει δεν μπορούν να ενημερωθούν μέσω αυτής της ροής εργασίας.

curl --silent --show-error --fail-with-body --user "$API_USER:$API_PASSWORD" \
  "https://api.multitel.net/tcr/v2/campaign/$CAMPAIGN_ID"

Επιλέξτε τα πεδία που άλλαξαν πραγματικά

Προετοιμάστε το campaign-update.json με τις υποστηριζόμενες αλλαγές. Η τρέχουσα πύλη στέλνει μόνο τα πεδία της καμπάνιας που άλλαξαν και δεν στέλνει brandId, usecase, campaignId ή πληροφορίες κατάστασης που περιλαμβάνονται μόνο στις αποκρίσεις. Οι απευθείας ενημερώσεις μέσω API χρησιμοποιούν επίσης ένα αντικείμενο JSON με πεδία, όχι την περιβάλλουσα δομή changes/version της πύλης.

Το σχήμα ενημέρωσης δεν προσφέρει τα brandId, usecase, subscriberOptin, subscriberOptout ή subscriberHelp ως τροποποιήσιμα πεδία. Μην αντιγράφετε ολόκληρο το σώμα αιτήματος δημιουργίας καμπάνιας σε μια ενημέρωση. Συμβουλευτείτε την τρέχουσα αξιολόγηση καταλληλότητας όταν εξετάζετε τις απαιτήσεις για τα μηνύματα.

Υποβολή στοχευμένης διόρθωσης

Αυτό το παράδειγμα περιγράφει ενδεικτικά μια υπηρεσία υπενθύμισης ραντεβού. Πριν το χρησιμοποιήσετε, προσαρμόστε το στην πραγματική υπηρεσία της καμπάνιας και στη ροή λήψης συγκατάθεσης που ακολουθεί.

{
  "description": "Appointment reminders requested by customers of the registered business.",
  "sample1": "Example business: Your requested appointment reminder is ready. Reply STOP to opt out."
}

curl --silent --show-error --fail-with-body --user "$API_USER:$API_PASSWORD" \
  --request PUT \
  --header 'Content-Type: application/json' \
  --header "Idempotency-Key: $IDEMPOTENCY_KEY" \
  --data-binary @campaign-update.json \
  "https://api.multitel.net/tcr/v2/campaign/$CAMPAIGN_ID"

Για την ίδια επιδιωκόμενη υποβολή, διατηρήστε το ίδιο κλειδί και ακριβώς την ίδια μέθοδο, διαδρομή, παραμέτρους ερωτήματος και byte του σώματος. Το τροποποιημένο περιεχόμενο απαιτεί αίτημα που έχει ελεγχθεί ξεχωριστά· μην αλλάζετε τυφλά κλειδιά μετά από λήξη του χρονικού ορίου. Ένα ολοκληρωμένο αίτημα μπορεί να επιστρέψει ξανά σφάλμα από την προσωρινή μνήμη και ένα διπλότυπο αιτήματος που βρίσκεται υπό επεξεργασία μπορεί να επιστρέψει 409 με Retry-After.

Διαβάστε ξανά την καμπάνια

Η απόκριση HTTP 200 επιστρέφει απευθείας ένα αντικείμενο JSON της καμπάνιας. Επαληθεύστε το campaignId, κατόπιν εκτελέστε GET για την ίδια καμπάνια και συγκρίνετε τα πεδία που σκοπεύατε να αλλάξετε. Η επιτυχής αποθήκευση δεν ζητά από μόνη της νέο έλεγχο από τον τηλεπικοινωνιακό πάροχο, δεν αλλάζει τις αντιστοιχίσεις αριθμών, δεν ενεργοποιεί την αποστολή και δεν στέλνει μήνυμα.

Η πύλη ελέγχει την έκδοση της φόρμας πριν από την αποθήκευση και διαβάζει ξανά την καμπάνια μετά την αποθήκευση. Το δημόσιο τελικό σημείο PUT δεν επιβάλλει τον έλεγχο αυτής της έκδοσης της πύλης: συντονίστε τις ταυτόχρονες επεξεργασίες. Ένα κλειδί ιδιοδυναμίας δεν εντοπίζει την ενημέρωση από άλλον χρήστη που επεξεργάζεται την καμπάνια.

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

Στην τρέχουσα υπηρεσία, οι συνήθεις ενημερώσεις καμπάνιας μέσω PUT δεν ενεργοποιούν χωριστή χρέωση εγγραφής καμπάνιας. Οι υπάρχουσες μηνιαίες χρεώσεις, οι ελάχιστες δεσμεύσεις, η μίσθωση αριθμών και οι χρεώσεις χρήσης μηνυμάτων εξακολουθούν να ισχύουν. Για τις τρέχουσες διαμορφωμένες τιμές καμπανιών, δείτε τις χρεώσεις καμπανιών.

Αντιμετώπιση περιορισμών και αβέβαιων αποτελεσμάτων

Για HTTP 400, διαβάστε το σφάλμα του συγκεκριμένου πεδίου και ελέγξτε τα μήκη, το κείμενο συγκατάθεσης και την κατάσταση της καμπάνιας. Για 401, 403 ή 404, ελέγξτε τα διαπιστευτήρια API, την επιτρεπόμενη IP προέλευσης και το αν η καμπάνια ανήκει στον λογαριασμό. Για 429, τηρήστε το Retry-After. Για 500, 502 ή αίτημα που διακόπηκε, διατηρήστε το αναγνωριστικό της καμπάνιας και τυχόν requestId και κατόπιν ελέγξτε και συμφωνήστε την υπάρχουσα εγγραφή με την επιδιωκόμενη κατάσταση πριν από νέα υποβολή.

Το τοπικό στιγμιότυπο εξαρτάται από το σώμα που επιστρέφεται. Μια μη κενή μερική απόκριση μπορεί να παραλείπει παλαιότερα πεδία, συμπεριλαμβανομένων των μεταδεδομένων ανανέωσης· μια κενή απόκριση μπορεί να διατηρεί παρωχημένες τιμές. Επαληθεύστε το πλήρες αποτέλεσμα του GET αντί να θεωρείτε την επιτυχία από μόνη της απόδειξη ότι διατηρήθηκαν όλα τα πεδία. Αναφέρετε τις διαφορές που παραμένουν ανεπίλυτες στην υποστήριξη. Αυτή η διαδρομή δεν ενημερώνει ατομικά τις αντιστοιχίσεις τηλεπικοινωνιακών παρόχων και δεν παρέχει γενική ενέργεια αποκατάστασης της ενεργοποίησης στον τηλεπικοινωνιακό πάροχο.