Καταχώριση επωνυμίας μηνυμάτων

Καταχωρίστε την επιχείρηση πίσω από τα μηνύματά σας

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

Χρησιμοποιήστε αυτήν την τρέχουσα διαδρομή που ανήκει στον λογαριασμό μέσω HTTPS με έναν ενεργοποιημένο λογαριασμό API και την επιτρεπόμενη διεύθυνση IP προέλευσής του. Μην υποβάλλετε user_id, username ή το αναγνωριστικό κατόχου άλλου πελάτη. Η MultiTEL καταγράφει την ιδιοκτησία από τον λογαριασμό που έχει αυθεντικοποιηθεί.

Ξεκινήστε με ένα ρητό αίτημα sandbox

Η πύλη ορίζει από προεπιλογή το πεδίο mode της φόρμας της σε sandbox· ένα απευθείας αίτημα API πρέπει να περιλαμβάνει ρητά τη λογική τιμή JSON mock: true όταν σκοπεύετε να δημιουργήσετε εικονική επωνυμία. Η παράλειψη αυτής της σημαίας δεν αποτελεί εγγύηση sandbox και μπορεί να δημιουργήσει χρεώσιμη καταχώριση παραγωγής. Το πεδίο mode της πύλης δεν υποκαθιστά το πεδίο mock του API.

Προετοιμάστε ένα τοπικό αρχείο brand.json χρησιμοποιώντας τα παρακάτω πεδία. Αντικαταστήστε τα σύμβολα κράτησης θέσης με κατάλληλα δοκιμαστικά στοιχεία και τρέχοντες κωδικούς καταλόγου. Αυτό το παράδειγμα αφορά ιδιωτική κερδοσκοπική επιχείρηση· άλλοι τύποι οντοτήτων έχουν διαφορετικές απαιτήσεις.

{
  "entityType": "PRIVATE_PROFIT",
  "displayName": "Example business",
  "companyName": "Example legal business name",
  "ein": "YOUR_TAX_ID",
  "einIssuingCountry": "US",
  "phone": "+12025550123",
  "street": "123 Example Street",
  "city": "Example City",
  "state": "NY",
  "postalCode": "10001",
  "country": "US",
  "email": "contact@example.invalid",
  "brandRelationship": "BASIC_ACCOUNT",
  "vertical": "CURRENT_VERTICAL_CODE",
  "referenceId": "your-business-reference",
  "mock": true
}

Η επιχείρηση, η διεύθυνση, το τηλέφωνο και το αναγνωριστικό παραπάνω είναι σύμβολα κράτησης θέσης, όχι επιχειρηματική ταυτότητα έτοιμη για καταχώριση. Λάβετε τρέχουσες τιμές για entityType, vertical, country, state, brandRelationship και άλλες απαριθμήσεις από τους καταλόγους μηνυμάτων.

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

Πεδία επιχείρησης και επικοινωνίας

Οι ατομικοί επιχειρηματίες υποστηρίζονται για καταχωρίσεις στις ΗΠΑ ή τον Καναδά και χρειάζονται επαλήθευση OTP πριν από την επιλεξιμότητα καμπάνιας. Οι εισηγμένες εταιρείες μπορεί να απαιτούν βήμα επικύρωσης επιχειρηματικής επικοινωνίας. Το GOVERNMENT προορίζεται για κυβερνητικές οντότητες με έδρα τις ΗΠΑ· επιβεβαιώστε τη σωστή κατηγορία οντότητας για άλλους οργανισμούς. Ακολουθήστε τις απαιτήσεις ανά τύπο οντότητας καθώς και τα επιστρεφόμενα σφάλματα επικύρωσης.

Διατηρήστε ένα σταθερό κλειδί idempotency

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

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

Διατηρήστε το brand.json αμετάβλητο ενώ επιλύετε αυτό το αίτημα. Ένα αποθηκευμένο στην προσωρινή μνήμη 500 ή 502 μπορεί να αναπαραγάγει το αρχικό σφάλμα αντί να επαναλάβει την καταχώριση. Διατηρήστε κάθε επιστρεφόμενο brandId, requestId και κεφαλίδες συσχέτισης· ελέγξτε την πραγματική κατάσταση της υπάρχουσας επωνυμίας και επιλύστε τυχόν ασυμφωνίες πριν ξεκινήσετε διαφορετικό αίτημα.

Διαβάστε την επωνυμία και την κατάστασή της

Αυτό το API χρησιμοποιεί κωδικούς κατάστασης HTTP και απευθείας σώμα JSON, αντί για τον φάκελο status/response της έκδοσης v3. Η επιτυχής καταχώριση επιστρέφει ένα αντικείμενο επωνυμίας που περιλαμβάνει brandId. Αποθηκεύστε αυτό το αναγνωριστικό και εξετάστε την επιστρεφόμενη κατάσταση επικύρωσης ή ταυτότητας. Τα επιπλέον πεδία εξαρτώνται από την οντότητα και την κατάσταση της καταχώρισης.

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

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

Τέλη παραγωγής

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

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

Χειριστείτε τα σφάλματα χωρίς να δημιουργήσετε διπλότυπη επωνυμία