Καταχωρίστε μια καμπάνια 10DLC

Ελέγξτε την επιλεξιμότητα μιας επωνυμίας πριν καταχωρίσετε την καμπάνια της

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

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

Διατηρήστε χωριστά το δοκιμαστικό περιβάλλον και την παραγωγή

Για δοκιμαστική άσκηση, χρησιμοποιήστε τη δική σας εικονική επωνυμία και μια τρέχουσα περίπτωση χρήσης για την οποία αυτή είναι επιλέξιμη. Χρησιμοποιήστε το TRIAL μόνο όταν προσφέρεται από αυτόν τον έλεγχο επιλεξιμότητας. Η πύλη ελέγχει ότι η επιλεγμένη επωνυμία και το περιβάλλον καμπάνιας συμφωνούν. Ένα άμεσο αίτημα API δεν εκτελεί για εσάς την πλήρη επικύρωση του οδηγού της πύλης, οπότε διατηρήστε αυτόν τον διαχωρισμό στην ενοποίησή σας.

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

Υποβάλετε το JSON καμπάνιας

Προετοιμάστε το campaign.json με τις επιλέξιμες τιμές σας. Το R000000 σημαίνει χωρίς μεταπωλητή. Χρησιμοποιήστε το μόνο όταν αυτή είναι η προβλεπόμενη διαμόρφωση. Για την κανονική διαμόρφωση μεταπωλητή MultiTEL, λάβετε το επιτρεπόμενο αναγνωριστικό μεταπωλητή MultiTEL LLC από τη συλλογή μεταπωλητών του λογαριασμού σας ή από τη ροή προετοιμασίας της πύλης, αντί να ενσωματώσετε σταθερά το αναγνωριστικό κάποιου άλλου.

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  'https://api.multitel.net/tcr/v2/reseller?companyName=MultiTEL%20LLC&recordsPerPage=500'

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

{
  "brandId": "B123ABC",
  "channelId": "10DLC",
  "usecase": "TRIAL",
  "subUsecases": [],
  "resellerId": "R000000",
  "description": "Trial account notices requested by users of the example application.",
  "messageFlow": "Test users explicitly select an unchecked consent box before requesting these trial notices.",
  "sample1": "Example application: your requested account notice is available. Reply STOP to stop notices.",
  "subscriberOptin": true,
  "optinKeywords": "START",
  "optinMessage": "You are subscribed to the example application's requested account notices.",
  "subscriberOptout": true,
  "optoutKeywords": "STOP",
  "optoutMessage": "You will no longer receive the example application's account notices.",
  "subscriberHelp": true,
  "helpKeywords": "HELP",
  "helpMessage": "For help with example account notices, contact support@example.invalid.",
  "embeddedLink": false,
  "embeddedPhone": false,
  "numberPool": false,
  "ageGated": false,
  "directLending": false,
  "termsAndConditions": true,
  "autoRenewal": false,
  "mnoIds": [],
  "referenceId": "your-trial-reference"
}

Ορίστε το termsAndConditions σε true μόνο αφού το εξουσιοδοτημένο άτομο έχει ελέγξει και αποδεχθεί τους ισχύοντες όρους. Το παράδειγμα δεν αποτελεί συναίνεση εκ μέρους σας. Χρησιμοποιήστε λογικές τιμές JSON για τις σημαίες, όχι συμβολοσειρές σε εισαγωγικά.

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

Πεδία καμπάνιας και απαιτήσεις υπό συνθήκη

Το δημοσιευμένο σχήμα περιέχει ορισμένες ασυνεπείς χρήσεις κεφαλαίων στους περιγραφικούς πίνακες. Το τρέχον αίτημα πύλης χρησιμοποιεί τα subscriberOptin και subscriberOptout όπως φαίνεται παραπάνω. Διατηρήστε αυτή την ακριβή χρήση πεζών/κεφαλαίων. Αυτός ο οδηγός καλύπτει τη ροή 10DLC για μισθωτές. Μην συμπεράνετε ότι τα απαιτούμενα πεδία ή τα βήματα ενεργοποίησης διαφορετικού καναλιού είναι τα ίδια.

Επαναλάβετε με ασφάλεια το ίδιο προβλεπόμενο αίτημα

Χρησιμοποιήστε ένα Idempotency-Key για αυτή την προβλεπόμενη δημιουργία. Το κλειδί είναι 1–128 εκτυπώσιμοι χαρακτήρες ASCII χωρίς κενά και περιορίζεται στον λογαριασμό κατόχου. Διατηρήστε αμετάβλητα σε επανάληψη τη μέθοδο HTTP, τη διαδρομή, τη συμβολοσειρά ερωτήματος και τα ακριβή byte του σώματος. Ένα αναδιαμορφωμένο αρχείο JSON συγκρούεται ακόμη και αν οι τιμές του είναι ισοδύναμες.

Ένα διπλότυπο σε εξέλιξη μπορεί να επιστρέψει HTTP 409 με Retry-After. Ολοκληρωμένα αιτήματα μπορεί να αναπαράγουν την αποθηκευμένη απόκρισή τους. Ένα αποθηκευμένο σφάλμα δεν αποδεικνύει ότι το μητρώο δεν δημιούργησε τίποτα. Αποθηκεύστε τα campaignId, requestId και τυχόν κεφαλίδες συσχέτισης, επιθεωρήστε την υπάρχουσα καμπάνια και διευθετήστε τυχόν μερική αποτυχία πριν εξετάσετε νέο κλειδί.

Ένα αναγνωριστικό καμπάνιας δεν είναι η τελική ρύθμιση αποστολής

Η απόκριση χρησιμοποιεί κατάσταση HTTP και άμεσο JSON. Σε επιτυχή δημιουργία, κρατήστε το campaignId και διαβάστε την τρέχουσα κατάστασή του:

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

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

Χρησιμοποιήστε την ενοποιημένη ροή δημιουργίας παραγωγής της πύλης όταν χρειάζεστε τη συνδυασμένη ακολουθία καταχώρισης, κοινοποίησης και φόρτωσης φορέα. Για καμπάνια παραγωγής που έχει ήδη δημιουργηθεί απευθείας από αυτό το API, διατηρήστε το αναγνωριστικό καμπάνιας της και διευθετήστε τη ρύθμιση φορέα του λογαριασμού μέσω υποστήριξης. Η τρέχουσα διεπαφή πελάτη δεν εκθέτει γενικό κουμπί συνέχισης για κάθε καμπάνια παραγωγής που δημιουργήθηκε απευθείας. Μην δημιουργήσετε άλλη καταχώριση για να επαναλάβετε την ενεργοποίησή της. Επιβεβαιώστε ότι η καμπάνια είναι ενεργή και ότι η ρύθμιση φορέα έχει ολοκληρωθεί πριν από την αντιστοίχιση αριθμού αποστολής. Ο αριθμός πρέπει επίσης να σας ανήκει, να είναι ενεργός και να υποστηρίζει SMS. Η δημιουργία καμπάνιας δεν αποστέλλει μηνύματα.

Χρεώσεις καμπανιών παραγωγής

Αυτά τα ποσά λιανικής ελέγχθηκαν με την τρέχουσα διαμόρφωση πύλης στις 24 Οκτωβρίου 2026. Επιβεβαιώστε την τρέχουσα επιλέξιμη περίπτωση χρήσης και την εμφανιζόμενη τιμή πριν από παραγωγική υποβολή. Ένα monthlyFee σε απόκριση ελέγχου επιλεξιμότητας από το μητρώο δεν είναι αυτόματα η λιανική τιμή MultiTEL σας.

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

Αντιμετωπίστε σφάλματα επικύρωσης και μερικές αποτυχίες

Διαβάστε την ένδειξη HTTP status και το επιστρεφόμενο JSON. Τα σφάλματα επικύρωσης μπορεί να είναι πίνακες αντικειμένων code/description. Τα τοπικά σφάλματα μπορεί αντίθετα να είναι αντικείμενα με message, status και, για ορισμένα σφάλματα επεξεργασίας, requestId.