დაარეგისტრირეთ 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 მეთოდი, გზა, მოთხოვნის სტრიქონი და სხეულის ზუსტი ბაიტები უცვლელად. ხელახლა ფორმატირებული JSON ფაილი კონფლიქტს იწვევს მაშინაც კი, თუ მისი მნიშვნელობები ეკვივალენტურია.

მიმდინარე დუბლიკატმა შეიძლება დააბრუნოს HTTP 409 Retry-After-თან ერთად; დასრულებულმა მოთხოვნებმა შეიძლება გაიმეორონ შენახული პასუხი. ქეშირებული შეცდომა არ ადასტურებს, რომ რეესტრმა არაფერი შექმნა. შეინახეთ campaignId, requestId და ნებისმიერი კორელაციის სათაურები, შეამოწმეთ არსებული კამპანია და შეამოწმეთ ფაქტობრივი მდგომარეობა და აღმოფხვერით ნაწილობრივი ხარვეზით გამოწვეული შეუსაბამობები ახალი გასაღების განხილვამდე.

კამპანიის ID არ არის საბოლოო გასაგზავნი მოწყობა

პასუხი იყენებს HTTP სტატუსს და პირდაპირ JSON-ს. წარმატებული შექმნისას შეინახეთ campaignId და წაიკითხეთ მისი მიმდინარე მდგომარეობა:

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

მიმდინარე პორტალის საპროდუქციო სამუშაო პროცესი ასევე აზიარებს კამპანიას შეტყობინებების ოპერატორთან და ტვირთავს ბრენდს/კამპანიას გამგზავნ ანგარიშში. ეს ცალკე ოპერაციებია ამ საჯარო შექმნის გამოძახებისგან. რეესტრის კამპანია შეიძლება არსებობდეს მაშინაც კი, თუ შემდგომი გაზიარების ან ოპერატორთან ჩატვირთვის ნაბიჯი ვერ შესრულდა.

გამოიყენეთ პორტალის ინტეგრირებული საპროდუქციო შექმნის სამუშაო პროცესი, როდესაც გჭირდებათ რეგისტრაციის, გაზიარებისა და ოპერატორთან ჩატვირთვის გაერთიანებული თანმიმდევრობა. საპროდუქციო კამპანიისთვის, რომელიც უკვე პირდაპირ შეიქმნა ამ API-ით, შეინარჩუნეთ მისი კამპანიის ID და ანგარიშის ოპერატორთან მოწყობა მხარდაჭერის მეშვეობით შეაჯერეთ. მიმდინარე სამომხმარებლო ინტერფეისი არ აჩვენებს გაგრძელების ზოგად ღილაკს ყველა პირდაპირ შექმნილი საპროდუქციო კამპანიისთვის. არ შექმნათ სხვა რეგისტრაცია მისი აქტივაციის გასამეორებლად. დაადასტურეთ, რომ კამპანია აქტიურია და ოპერატორთან მოწყობა დასრულებულია შემდეგი ნაბიჯის წინ: გამგზავნი ნომრის მინიჭება. ნომერი ასევე უნდა იყოს საკუთარი, აქტიური და SMS-ჩართული. კამპანიის შექმნა შეტყობინებებს არ აგზავნის.

საპროდუქციო კამპანიების ტარიფები

ეს საცალო თანხები შემოწმდა მიმდინარე პორტალის კონფიგურაციასთან 24 ოქტომბერს (2026 წელს). დაადასტურეთ მიმდინარე კვალიფიციური გამოყენების შემთხვევა და ნაჩვენები ფასი საპროდუქციო გაგზავნამდე. monthlyFee რეესტრის კვალიფიკაციის პასუხში ავტომატურად არ არის თქვენი MultiTEL საცალო ფასი.

მიმდინარე პორტალი ადგენს სამთვიან მინიმალურ ვალდებულებას არაპოლიტიკური საპროდუქციო კამპანიებისთვის. დადასტურებამდე გადახედეთ მოქმედ პირობებს და განახლების არჩევანს. რეგისტრაცია, ნომრის ქირაობა, დამატებითი შემოწმება და შეტყობინებების გამოყენება ცალკე გადასახადებია. წარმატებული შექმნის პასუხი დამოუკიდებლად არ ადასტურებს, რომ ბილინგის თუ ოპერატორთან აქტივაციის ყველა ნაბიჯი დასრულებულია.

ვალიდაციისა და ნაწილობრივი ხარვეზების დამუშავება

წაიკითხეთ HTTP status და დაბრუნებული JSON. ვალიდაციის ხარვეზები შეიძლება იყოს code/description ობიექტების მასივები; ლოკალური ხარვეზები კი შეიძლება იყოს ობიექტები message-ით, status-ით და, ზოგიერთი დამუშავების შეცდომისთვის, requestId-ით.