Udostępnij przez


Messaging Connect

Important

Ta funkcja usługi Azure Communication Services jest obecnie dostępna w wersji próbnej. Funkcje w wersji zapoznawczej są publicznie dostępne i mogą być używane przez wszystkich nowych i istniejących klientów firmy Microsoft.

API i zestawy SDK w wersji zapoznawczej są dostarczane bez umowy na poziomie usług. Zalecamy, aby nie używać ich do obciążeń produkcyjnych. Niektóre funkcje mogą nie być obsługiwane lub mogą być ograniczone.

Aby uzyskać więcej informacji, zobacz Warunki dodatkowe korzystania z testowych wersji Microsoft Azure.

Introduction

Witamy w programie Messaging Connect— nowy sposób dostarczania usługi Short Message Service (SMS) globalnie za pomocą usług Azure Communication Services. Integruje zaufanych partnerów, aby można było dzierżawić numery i spełniać lokalne wymagania prawne, jednocześnie korzystając ze znanych usług Azure Communication Services: pojedynczego punktu końcowego interfejsu API, silnej obserwacji i głębokiej integracji między usługami firmy Microsoft. Niezależnie od tego, czy wysyłasz przypomnienia o spotkaniach, potwierdzenia rezerwacji, czy inteligentne monity Copilot, Messaging Connect pomaga dotrzeć do użytkowników na całym świecie z mniejszą złożonością.

Zamiast tworzyć i utrzymywać oddzielne integracje z wieloma dostawcami, połączysz się raz za pośrednictwem usług Azure Communication Services i kierujesz ruch do partnerów globalnych. Partner obsługuje dzierżawę numerów i zgodność z przepisami. Przepływy pracy dotyczące obsługi komunikacji, obserwowalności i sztucznych inteligencji pozostają w środowisku Azure, gdzie już tworzysz, monitorujesz i skalujesz.

Wartość na pierwszy rzut oka:

  • Globalny zasięg w 190 krajach+

  • Lokalna zgodność i szybsze udostępnianie za pośrednictwem partnerów

  • Proste używanie interfejsów API/zestawów SDK usług Azure Communication Services, diagnostyki i możliwości obserwowania usługi Event Grid

  • Rozdzielenie obowiązków: firma Microsoft udostępnia platformę programistyczną; partnerzy dostarczają i udostępniają numery

Omówienie pojęć koncepcyjnych

Globalna wiadomość SMS jest z natury złożona: przepisy różnią się w zależności od kraju, typy nadawców różnią się, a trasy dostarczania są fragmentowane. Messaging Connect integruje wstępnie zatwierdzonych partnerów, aby umożliwić uzyskanie zgodnych tożsamości nadawcy i kierowanie ruchu bez opuszczania środowiska dewelopera Azure Communication Services.

Przepływ aprowizacji (wysoki poziom):

  1. W portalu Azure przejdź do sekcji Messaging Connect

  2. Wybierz partnera Messaging Connect.

  3. Nastąpi przekierowanie do portalu partnera w celu zakupu/skonfigurowania numerów telefonów obsługujących wiadomości SMS, ukończenia wymaganych rejestracji i oczekiwania na zatwierdzenie.

  4. Partner synchronizuje zatwierdzone numery z powrotem z zasobem usług Azure Communication Services.

  5. Numer pojawia się w Azure Portal i jest gotowy do użycia z interfejsami API SMS Azure Communication Services.

Diagram przedstawiający przepływ przydziału numerów Messaging Connect na platformie Azure.

Możesz wysyłać i odbierać wiadomości SMS przy użyciu standardowych interfejsów API programu SMS usług Azure Communication Services. Podczas wysyłania wiadomości uwierzytelniasz się na platformie Azure w zwykły sposób i dołączasz klucz od partnera Messaging Connect w czasie rzeczywistym, abyśmy mogli odpowiednio kierować ruch. Partner obsługuje dostarczanie komunikatów, podczas gdy obserwowalność — taka jak potwierdzenia dostarczenia, diagnostyka i rejestrowanie — pozostaje w Azure wraz z innymi usługami.

Ten model działa dobrze w rzeczywistych scenariuszach. Możesz użyć narzędzia Messaging Connect, aby dotrzeć do użytkowników na całym świecie — niezależnie od tego, czy tworzysz asystenta opartego na sztucznej inteligencji za pomocą programu Copilot Studio, zarządzasz logistyką, która wymaga identyfikatorów lokalnych nadawców w Brazylii i Indiach, czy koordynujesz kampanie w dziesiątkach krajów. Usługi Azure Communication Services, za pośrednictwem programu Messaging Connect, umożliwiają uzyskiwanie właściwych tożsamości nadawców za pośrednictwem zaufanego partnera i używanie ich z preferowanym zestawem SDK programu SMS usług Azure Communication Services — przy jednoczesnym zachowaniu pełnej kontroli i możliwości wglądu na platformie Azure.

Diagram przedstawiający architekturę przy użyciu interfejsu API Messaging Connect i ACS.

Capabilities

Poniższa tabela zawiera podsumowanie możliwości dostępnych podczas korzystania z programu Messaging Connect w publicznej wersji zapoznawczej. Niektóre funkcje są udostępniane bezpośrednio przez platformę Azure, a inne przez partnerów Messaging Connect.

Capability Supported
Obsługiwani partnerzy Infobip (wkrótce pojawi się więcej partnerów)
Długie kody ✔️
Identyfikator dynamicznego alfanumerycznego nadawcy ✔️
Krótkie kody ❌ (wkrótce)
Identyfikator wstępnie zarejestrowanego nadawcy Alpha (zarządzany przez partnera) ✔️
Dwukierunkowa komunikacja wiadomości ✔️
Jednokierunkowe przesyłanie wiadomości ✔️
1:1 (pojedynczy odbiorca) ✔️
1:N (obsługa komunikatów zbiorczych) ✔️
Pokrycie w 190+ krajach ✔️
Raporty dostarczenia (DLR) ✔️
Usługa Event Grid dla komunikatów przychodzących ✔️
Opcja rezygnacji zarządzana przez partnera ✔️
Lokalne wymuszanie przepisów ✔️
Zestaw SDK języka C# ✔️
Zestaw SDK dla języka JavaScript ✔️
Zestaw SDK dla języka Python ❌ (wkrótce)
Java SDK ❌ (wkrótce)
Wybór automatycznego nadawcy kraju (zarządzany przez partnera) Infobip ✔️

🌐 Dostępność kraju

Usługa Messaging Connect znacznie rozszerza liczbę krajów, z którymi można się skontaktować za pomocą usług Azure Communication Services — obsługujących ponad 190 krajów za pośrednictwem naszej globalnej sieci partnerskiej. W publicznej wersji zapoznawczej można uzyskać i użyć dwóch typów tożsamości nadawcy od partnera Messaging Connect:

  • Long Codes — standardowe lokalne numery telefonów lub numery telefonów komórkowych, które obsługują dwukierunkową wiadomość SMS. Często nazywane wirtualnymi długimi kodami.
  • Identyfikatory dynamicznych alfanumerycznych nadawców — nadawcy z marką jednokierunkową (na przykład "CONTOSO"), gdzie jest to dozwolone. Identyfikator DASID można włączyć tylko w krajach nieobsługiwanych przez Azure Communication Services.

Podczas wyszukiwania kraju i typu numeru w witrynie Azure Portal jest oferowana opcja Messaging Connect, jeśli usługi Azure Communication Services nie obsługują tej konfiguracji bezpośrednio. Następnie należy ukończyć proces konfiguracji przez portal partnera.

Partner Messaging Connect określa dostępność kraju. Partner Programu Messaging Connect (na przykład Infobip) obsługuje typy liczb, wymagania dotyczące zgodności i kroki dołączania, które różnią się w zależności od kraju.

Partner Zasięg globalny Obsługiwane kraje
Infobip Infobip, połączony z ponad 800 operatorami w ponad 200 krajach, obsługuje krótkie kody, długie kody (VLN) oraz alfanumerycznych nadawców. Jednokierunkowa wiadomość SMS jest dostępna na prawie wszystkich rynkach; dwukierunkowe w 100 krajach. Wyświetl zasięg Infobip.

Uwierzytelnianie: bezpieczny dostęp przy użyciu tożsamości platformy Azure

Aby wysyłać komunikaty za pośrednictwem programu Messaging Connect, aplikacja musi uwierzytelniać się w usługach Azure Communication Services przy użyciu jednego z obsługiwanych modeli tożsamości. Ten krok sprawdza, czy aplikacja ma uprawnienia do wysyłania komunikatów za pośrednictwem zasobu usług Azure Communication Services i zapewnia, że komunikaty są skojarzone z poprawną subskrypcją platformy Azure.

Usługi Azure Communication Services obsługują następujące metody uwierzytelniania:

  • Uwierzytelnianie klucza dostępu (parametry połączenia)
  • Uwierzytelnianie Microsoft Entra ID

Uwierzytelniasz się za pomocą usług Azure Communication Services w taki sam sposób, jak w przypadku dowolnego innego żądania SMS. Program Messaging Connect nie zmienia sposobu działania uwierzytelniania na poziomie platformy — po zweryfikowaniu komunikatu po prostu dodaje krok routingu opartego na partnerach.

Dowiedz się więcej: Uwierzytelnianie w usługach Azure Communication Services

Po uwierzytelnieniu Twoja aplikacja również uwzględnia klucz API partnera w czasie wykonywania, aby przekierować komunikat za pośrednictwem odpowiedniego partnera programu Messaging Connect. Ten klucz interfejsu API partnera jest częścią ładunku komunikatu i został szczegółowo opisany w następnej sekcji.

Jak Messaging Connect weryfikuje twoje żądania

Przed wysłaniem komunikatu przy użyciu programu Messaging Connect platforma Azure sprawdza, czy żądanie zawiera niezbędne informacje o routingu i jest poprawnie uwierzytelnione. Aby wykonać ten krok, ładunek musi zawierać określone metadane, które identyfikują partnera Programu Messaging Connect i umożliwiają usługom Azure Communication Services kierowanie komunikatu za pośrednictwem infrastruktury.

Wymagany format ładunku

W przypadku wysyłania wiadomości przy użyciu numeru programu Messaging Connect, żądanie musi zawierać obiekt messagingConnect. Ten obiekt zawiera klucz interfejsu API dostarczony przez partnera Messaging Connect (na przykład Infobip) i nazwę partnera. Platforma Azure używa tych informacji do autoryzowania żądania i określania sposobu kierowania komunikatu.

{
  "from": "+447700900123",
  "to": ["+447700900456"],
  "message": "Hello from Messaging Connect!",
  "options": {
    "messagingConnect": {
      "apiKey": "your-partner-api-key",
      "partner": "[PARTNER NAME]"
    }
  }
}

Obiekt messagingConnect jest wymagany za każdym razem, gdy używasz liczby skonfigurowanej za pośrednictwem Messaging Connect. Jeśli brakuje go lub jest on nieprawidłowo skonfigurowany, usługi Azure Communication Services odrzucają komunikat. Po dołączeniu tych metadanych usługi Azure Communication Services przeprowadza sprawdzanie poprawności w dwóch etapach: najpierw usługa Azure Communication Services weryfikuje żądanie natychmiast po odebraniu, a następnie ponownie po przesłaniu go do partnera.

Walidacja synchroniczna

Ta pierwsza warstwa weryfikacji jest wykonywana natychmiast po odebraniu żądania komunikatu przez usługi Azure Communication Services. Jeśli brakuje czegoś lub jest on nieprawidłowy — na przykład nazwa partnera, klucz interfejsu API lub skojarzenie między numerem a zasobem usług Azure Communication Services — otrzymasz natychmiastową odpowiedź o błędzie. Ta kontrola uniemożliwia niepoprawne wysyłanie komunikatów lub kierowanie ich do niewłaściwego partnera.

Typowe wyniki walidacji:

Scenario Response
Brakujące messagingConnect pola 400 Nieprawidłowe żądanie ze szczegółami weryfikacji
Nieautoryzowany numer nadawcy 401 Brak autoryzacji
Brak messagingConnect numeru telefonu dla programu Messaging Connect 400 Nieprawidłowe żądanie — opcja "MessagingConnect nie jest podana"
Niezgodność partnerów 400 Nieprawidłowe żądanie — "MessagingConnect opcja nie jest zgodna z informacjami o numerze".

Te błędy są zwracane synchronicznie w odpowiedzi z interfejsu API i pojawiają się również w diagnostyce i dziennikach platformy Azure.

Błędy dostarczania asynchronicznego

Nawet jeśli żądanie przejdzie synchroniczną walidację, usługi Azure Communication Services mogą nadal nie przekazać go partnerowi programu Messaging Connect. W niektórych przypadkach usługi Azure Communication Services zatrzymują komunikat przed przekazaniem — na przykład jeśli odbiorca wcześniej zrezygnował lub istnieje znany blok dostarczania od partnera. Te sytuacje nadal powodują wyświetlenie raportu dostarczania, więc zawsze będziesz informowany o wyniku komunikatu. Po przekazaniu komunikatu do partnera wszelkie błędy dostarczania podrzędnego — takie jak liczba nieosiągalna, wygasły okres ważności lub odrzucenie na poziomie przewoźnika — są również zwracane asynchronicznie za pośrednictwem raportów dostawy. Stan dostarczania można wyświetlić w raportach dostarczania zdarzeń usługi Azure Event Grid (jeśli zostały skonfigurowane).

Dowiedz się więcej: Raporty dostarczania dotyczące zdarzeń usługi Azure Event Grid

Tip

Aby zapewnić pełny wgląd w ruch komunikatów, zdecydowanie zalecamy skonfigurowanie subskrypcji zdarzeń dla raportów dostarczeń. Ta konfiguracja umożliwia monitorowanie stanu komunikatów, rozwiązywanie problemów z błędami i integrowanie z istniejącymi systemami telemetrii. Dowiedz się, jak skonfigurować zdarzenia SMS: Obsługa zdarzeń SMS

Note

Jeśli komunikat nie powiedzie się, sprawdź messagingConnect obiekt pod kątem dokładności, przejrzyj raport dostarczania i zapoznaj się z dokumentacją partnera, aby uzyskać kody błędów podrzędnych.

Important

Firma Microsoft nie zachowuje żadnych poświadczeń używanych do uzyskiwania dostępu do zewnętrznych partnerów programu Messaging Connect. Klucze interfejsu API partnera są używane tylko do przetwarzania każdego żądania wiadomości i są natychmiast odrzucane po zakończeniu żądania. Te poświadczenia nie są przechowywane, rejestrowane ani utrwalane w żadnej formie.

Dostęp globalny z bezpiecznymi i zgodnymi komunikatami

Program Messaging Connect jest tworzony do użytku globalnego — niezależnie od tego, czy korzystasz z Azji, Afryki, Ameryki Południowej, czy Unii Europejskiej. W tej sekcji wyjaśniono, jak przepływy danych w różnych regionach, jak jest zachowywana prywatność oraz jak platforma Azure zapewnia zgodność z wymaganiami dotyczącymi rezydencji.

Routing komunikatów i przepływ danych

Usługa Messaging Connect oddziela dostarczanie komunikatów (obsługiwane przez partnera) od przetwarzania i obserwowania (obsługiwanego przez platformę Azure). Oto jak to działa:

  • Komunikaty wychodzące: wysyłasz wiadomość SMS przy użyciu interfejsu API usług Azure Communication Services i dołączasz informacje o routingu partnera za pośrednictwem messagingConnect obiektu. Platforma Azure rejestruje komunikat, przeprowadza walidację, a następnie kieruje go do wybranego partnera Messaging Connect.
  • Komunikaty przychodzące: partner odbiera wiadomość SMS i przekazuje ją do infrastruktury platformy Azure. Z tego miejsca usługi Azure Communication Services przetwarzają wiadomość tak, jak każdą inną wysyłaną do natywnych numerów usług Azure Communication Services, uruchamiając zdarzenia za pośrednictwem usługi Event Grid.

Mimo że partner obsługuje dostarczanie, platforma Azure zapewnia następujące możliwości:

  • Potwierdzenia dostawy i możliwość obserwowania
  • Standardowe interfejsy API i zestawy SDK usług komunikacyjnych Azure
  • Tylko przetwarzanie komunikatów przejściowych — żadna zawartość komunikatu nie jest przechowywana

Usługi Azure Communication Services nie zachowują zawartości wiadomości SMS po dostarczeniu lub niepowodzeniu. Komunikaty i metadane są przetwarzane tymczasowo w pamięci tylko w razie potrzeby na potrzeby routingu i diagnostyki.

Important

Firma Microsoft nie zachowuje żadnych poświadczeń używanych do uzyskiwania dostępu do zewnętrznych partnerów programu Messaging Connect. Klucze interfejsu API partnera są używane tylko do przetwarzania każdego żądania wiadomości i są natychmiast odrzucane po zakończeniu żądania. Te poświadczenia nie są przechowywane, rejestrowane ani utrwalane w żadnej formie.

Dowiedz się więcej: Miejsce przechowywania danych i prywatność użytkowników

Granica danych UE (EUDB)

Usługi Azure Communication Services gwarantują, że dane SMS w bazie danych EUDB są przechowywane w regionach EUDB. Obecnie przetwarzamy i przechowujemy dane w regionach Holandii, Irlandii lub Szwajcarii, zapewniając brak nieautoryzowanego transferu danych poza EOG (Europejski Obszar Gospodarczy). Ponadto, usługi Azure Communication Services stosują zaawansowane środki bezpieczeństwa, w tym szyfrowanie, aby chronić dane SMS zarówno w spoczynku, jak i podczas przesyłu. Klienci mogą wybrać preferowaną rezydencję danych w ramach bazy danych EUDB, upewniając się, że dane pozostają w wyznaczonych regionach UE.

Dowiedz się więcej: Granica danych Unii Europejskiej (EUDB)

Korzystanie z funkcji Messaging Connect z dowolnego miejsca

Program Messaging Connect jest przeznaczony do użytku globalnego. Po uzyskaniu liczby za pośrednictwem partnera programu Messaging Connect należy zintegrować go z aplikacją przy użyciu interfejsów API usług Azure Communication Services — niezależnie od tego, gdzie jest hostowana. Jednak niektóre kraje wymuszają lokalne reguły telekomunikacyjne dotyczące użycia numerów, dozwolonych typów zawartości lub wymagań dotyczących pochodzenia ruchu. Partner Messaging Connect zarządza tymi wymaganiami podczas procesu aprowizacji numerów. Partner, a nie usługi Azure Communication Services, optymalizuje trasy dostarczania. W zależności od typu numeru, reguł lokalnych i konfiguracji partnera komunikaty mogą być kierowane przez infrastrukturę lokalną lub regionalną.

Zarządzanie rezygnacją

Rezygnacja z subskrypcji i zgodność z zasadami opt-in są kluczowymi elementami wiadomości SMS, szczególnie na rynkach regulowanych. W przypadku programu Messaging Connect ta odpowiedzialność jest współdzielona między Tobą (klientem), partnerem (na przykład Infobip) i firmą Microsoft, z których każda odgrywa odrębną rolę.

Kluczowe obowiązki

  • Partner (na przykład Infobip) obsługuje wykrywanie słów kluczowych rezygnacji i subskrypcji, takich jak "STOP" lub "START", ale zachowanie nie jest automatyczne.

Note

Te słowa kluczowe należy jawnie skonfigurować za pośrednictwem portalu partnera. Infobip może zachować listę zablokowanych użytkowników, ale oczekujesz się, że będziesz zarządzać własną listą — zwłaszcza jeśli rezygnacja nastąpi za pośrednictwem innych kanałów (na przykład wiadomości e-mail lub formularzy internetowych).

  • Komunikaty potwierdzające, takie jak "anulowano subskrypcję", nie są domyślnie wysyłane. W razie potrzeby należy je jawnie skonfigurować z partnerem lub zaimplementować je we własnej aplikacji.
  • Klient jest odpowiedzialny za zapewnienie zgodności obsługi komunikatów z lokalnymi przepisami, w tym z obsługą rezygnacji, konfiguracją słów kluczowych i zarządzaniem zgodą użytkowników końcowych.
  • Usługi Azure Communication Services nie przetwarzają słów kluczowych rezygnacji ani nie wysyła żadnych automatycznych odpowiedzi. Jednak firma Microsoft utrzymuje zestaw wstępnie zdefiniowanych słów kluczowych pozwalających na rezygnację z obserwowalności.

Co robi usługa Azure Communication Services

Domyślnie usługi Azure Communication Services wykrywają standardowe słowa kluczowe związane z zapisem/rezygnacją: START i UNSTOP są rozpoznawane jako wyzwalacze do zapisu, podczas gdy polecenia STOP, ARRET, QUIT, END, REVOKE, OPT OUT, CANCEL i UNSUBSCRIBE są rozpoznawane jako polecenia rezygnacji. Gdy komunikat przychodzący odpowiada dokładnie jednemu z tych słów kluczowych, usługi Azure Communication Services automatycznie przetwarzają żądanie i aktualizują stan zgody użytkownika odpowiednio w naszej bazie danych.

Cennik i rozliczenia

Program Messaging Connect używa modelu podwójnej opłaty, aby oddzielić użycie platformy firmy Microsoft od usług dostarczania i dzierżawy partnera.

Co płacisz firmie Microsoft

Płacisz opłatę za platformę, aby korzystać z interfejsów API usług Azure Communication Services i infrastruktury dla programu Messaging Connect. Obejmuje to przetwarzanie komunikatów, diagnostykę, śledzenie dostarczania i możliwość obserwowania na poziomie interfejsu API.

  • Platforma Azure pobiera opłatę za platformę w wysokości 0,0025 USD za każde przesłane żądanie wysyłania wiadomości SMS — niezależnie od tego, czy wiadomość jest ostatecznie dostarczana przez partnera. Firma Microsoft nie pobiera opłat za dostawę.
  • Ta opłata to przedpłata za platformę Azure (inaczej zobowiązanie pieniężne) i kwalifikująca się do MACC (Zobowiązanie na Konsumpcję Azure) i pojawia się jako część zwykłej faktury Azure.

Partner Messaging Connect, a nie firma Microsoft, obsługuje dostarczanie komunikatów.

Co płacisz partnerowi

Płacisz partnerowi Messaging Connect bezpośrednio za:

  • Dzierżawa numeru telefonu (co miesiąc lub co rok)
  • Opłaty za dostawę komunikatów, które różnią się w zależności od kraju i trasy

Partner definiuje warunki handlowe i poziomy pomocy technicznej. Domyślnie partner Messaging Connect (na przykład Infobip) rozlicza Cię bezpośrednio za dostawę i opłaty za dzierżawę numerów. Te opłaty nie są wyświetlane na fakturze za platformę Azure, chyba że jawnie skonfigurujesz rozliczenia Marketplace. Nie ma żadnych ograniczeń subskrypcji. Możesz użyć funkcji Messaging Connect z dowolnym typem subskrypcji platformy Azure, w tym płatnością zgodnie z rzeczywistym użyciem i umowami Enterprise Agreement. W przeciwieństwie do ofert bezpośrednich wiadomości SMS firmy Microsoft program Messaging Connect nie jest usługą telekomunikacyjną — jest to model platformy deweloperskiej.

Partner Model opłaty za dostawę Szczegóły cennika
Infobip Model rozliczenia według zużycia dla wiadomości SMS. Wyświetl stawki sms infobip

Opcjonalnie: skonsolidowane rozliczenia za pośrednictwem witryny Azure Marketplace

Jeśli wolisz skonsolidować opłaty na fakturze za platformę Azure, możesz poprosić partnera o ofertę Messaging Connect za pośrednictwem witryny Azure Marketplace. Oto jak działa proces w Marketplace:

  1. Poproś partnera (Infobip) o przesłanie oferty prywatnej za pośrednictwem witryny Azure Marketplace.
  2. Administrator platformy Azure akceptuje ofertę w witrynie Azure Portal.
  3. Co miesiąc partner wysyła dane użycia do firmy Microsoft.
  4. Microsoft rozlicza cię w imieniu partnera (opłata przeniesiona).

Ta konfiguracja upraszcza zaopatrzenie i umożliwia, by użycie Messaging Connect było zaliczane do zobowiązania MACC platformy Azure.

Dowiedz się więcej: Azure Marketplace

Tip

Niezależnie od tego, czy wybierasz rozliczenia partnera, czy rozliczenia za pośrednictwem Marketplace, środowisko techniczne na platformie Azure pozostaje bez zmiany.

Środowisko dewelopera

Uzyskiwanie numeru telefonu za pomocą funkcji Messaging Connect

Program Messaging Connect wprowadza nowy model aprowizacji: zamiast pobierać numery bezpośrednio od firmy Microsoft, uzyskujesz je za pośrednictwem zaufanego partnera — począwszy od rozwiązania Infobip — a następnie połączysz je z zasobem usług Azure Communication Services. Ten proces umożliwia dostęp do numerów SMS w ponad 190 krajach, podczas gdy partner obsługuje lokalne przepływy zgodności, dokumentacji i zatwierdzania.

Tip

Jeśli dopiero zaczynasz korzystać z usług Azure Communication Services, zalecamy rozpoczęcie pracy z przewodnikiem Tworzenie zasobów usług komunikacyjnych , aby uzyskać konfigurację i gotowość do dołączania wiadomości SMS za pomocą programu Messaging Connect.

Przejdźmy krok po kroku:

  1. Wybieranie partnera programu Messaging Connect

    W witrynie Azure Portal w zasobie usługi Communication Services przejdź do bloku Messaging Connect i wybierz partnera z listy. Zaakceptuj warunki. Zostaniesz przekierowany na stronę internetową partnera, aby dokończyć proces zdobywania numeru.

Zrzut ekranu przedstawiający panel połączenia z wiadomościami.

Zrzut ekranu przedstawiający komunikaty łączące partnerów.

  1. Uzyskiwanie numeru w portalu partnera

    Aby kupić numer, postępuj zgodnie z monitami dostarczonymi przez partnera Messaging Connect. W zależności od kraju może być konieczne przekazanie dokumentów pomocniczych lub ukończenie weryfikacji tożsamości. Po zatwierdzeniu numer jest przypisywany do konta partnera.

    Ekran przedstawiający portal partnerski z zakupionymi numerami.

Tip

Potrzebujesz pomocy przy konfigurowaniu strony Infobip? Postępuj zgodnie z oficjalnym przewodnikiem, aby połączyć zasób usług Azure Communication Services z usługą Infobip i aprowizować numery wiadomości SMS:
Wiadomości SMS dla usług Microsoft Azure Communication Services — Messaging Connect

  1. Wróć do witryny Azure Portal

    Gdy partner potwierdzi, że Państwa numery są przydzielone, inicjują synchronizację z systemem Azure Communication Services. Po zakończeniu synchronizacji numery są automatycznie wyświetlane w zasobie ACS — gotowe do użycia z interfejsem API ACS SMS, podobnie jak każda liczba aprowizowana bezpośrednio za pośrednictwem Azure Communication Services. Po twojej stronie nie jest wymagana żadna dodatkowa konfiguracja.

    Zrzut ekranu przedstawiający udostępnione numery w portalu Azure.

    Note

    Partner Messaging Connect ustawia oś czasu zatwierdzania i aktywacji, która różni się w zależności od kraju i typu numeru. Program Messaging Connect nie obsługuje obecnie natychmiastowej aprowizacji, a firma Microsoft nie jest zaangażowana w proces weryfikacji ani zatwierdzania.

Ważne uwagi:

  • Firma Microsoft nie zarządza zgodnością ani weryfikacją numerów programu Messaging Connect. Partner zarządza tym procesem całkowicie.
  • Każdy partner ma różne przepływy aprowizacji i umowy dotyczące poziomu usług (SLA) w zależności od regionów i lokalnych przepisów telekomunikacyjnych.
  • Numery uzyskane za pośrednictwem programu Messaging Connect są wyświetlane w witrynie Azure Portal z etykietą "Nazwa operatora", aby można było je odróżnić od numerów zarządzanych przez usługi Azure Communication Services.
  • Aby wysyłać wiadomości z tymi numerami, nie zapomnij dołączyć obiektu MessagingConnect do żądania API.

Samouczek dotyczący zestawu SMS SDK

Note

Następujące wersje interfejsu API i zestawu SDK są obsługiwane w publicznej wersji zapoznawczej programu Messaging Connect:

Program Messaging Connect opiera się na istniejących możliwościach programu SMS usług Azure Communication Services. Używa tych samych interfejsów API i zestawów SDK programu SMS, więc jeśli znasz już wysyłanie wiadomości przy użyciu ACS — zwłaszcza jeśli ukończyłeś przewodnik Szybki start wysyłania wiadomości SMS — jesteś prawie gotowy/a. Pamiętaj, aby użyć metody Send SMS with options i uwzględnić obiekt MessagingConnect w opcjach.

Jeśli dopiero zaczynasz korzystać z usług Azure Communication Services, zacznij od ukończenia przewodnika Szybki start wysyłanie wiadomości SMS, aby móc skonfigurować uwierzytelnianie, utworzyć swój SmsClient, i poznać podstawową strukturę żądania wysyłania. Pamiętaj, aby uwzględnić MessagingConnect obiekt w żądaniu.

Ten obiekt zawiera:

  • Nazwa partnera (na przykład "infobip")
  • Klucz interfejsu API partnera otrzymany po uzyskaniu numeru

Token usług Azure Communication Services nadal autoryzuje żądanie do platformy Azure, a klucz partnera informuje, jak kierować wiadomość.

Tip

Jak uzyskać klucz API partnera z Infobip
Aby wysyłać komunikaty za pomocą funkcji Messaging Connect, potrzebujesz klucza interfejsu API Infobip:

  1. Zaloguj się do portalu Infobip przy użyciu poświadczeń Infobip.
  2. Wybierz pozycję Utwórz nowy klucz interfejsu API.
  3. W obszarze Zakresy interfejsu API włącz: sms:message:send.
  4. Zapisz klucz interfejsu API w bezpiecznej lokalizacji. Używasz go w wywołaniu interfejsu API Azure Communication Services.

W poniższych przykładach pokazano, jak wysłać komunikat za pomocą programu Messaging Connect przy użyciu języka C# i języka JavaScript.

Przykład w języku C#

smsClient.Send(
    from: "<YOUR-ACS-NUMBER>",
    to: ["<RECIPIENT-NUMBER>"],
    message: $"Hello from Azure Communication Services!",
    options: new SmsSendOptions(true)
    {
        MessagingConnect = new MessagingConnectOptions("<YOUR-INFOBIP-API-KEY>", "infobip")
    });

Przykład języka JavaScript

await smsClient.send(
    {
      from: "<YOUR-ACS-NUMBER>",
      to: ["<RECIPIENT-NUMBER>"],
      message: "Hello from Azure Communication Services! JS SDK is working!",
    },
    {
        enableDeliveryReport: true, // Optional: Enable delivery reports
        messagingConnect: {
          apiKey: "<YOUR-INFOBIP-API-KEY>",
          partner: "infobip"
      }
  });

Tip

Jeśli używasz numeru programu Messaging Connect, ale nie dołączasz obiektu messagingConnect, żądanie kończy się niepowodzeniem z powodu błędu weryfikacji. Aby uzyskać listę możliwych błędów walidacji i odpowiedzi, przejdź do tabeli wyników walidacji.

Kody błędów programu SMS

Podczas wysyłania wiadomości SMS za pośrednictwem programu Messaging Connect mogą wystąpić kody błędów — w ramach synchronicznej weryfikacji (natychmiastowej odpowiedzi interfejsu API) lub w raportach dostarczania asynchronicznego. Usługi Azure Communication Services korzystają z tego samego modelu błędów dla całej komunikacji SMS, włączając Messaging Connect.

Dowiedz się więcej: Zobacz pełną listę kodów błędów sms

Katalog partnerów Messaging Connect

Program Messaging Connect działa za pośrednictwem bezpośrednich integracji z zaufanymi globalnymi dostawcami programu SMS. Ci partnerzy obsługują aprowizowanie numerów, zgodność, dostarczanie i wymuszanie rezygnacji — podczas gdy Azure udostępnia platformę dla deweloperów, monitorowanie i orkiestrację komunikatów. W poniższej tabeli wymieniono obecnie obsługiwanych partnerów. W miarę upływu czasu zostanie dodanych więcej partnerów, aby zapewnić szerszy zakres i redundancję.

Partner Krótki opis Dostępność kraju/regionu Pricing
Infobip Globalna platforma komunikacji z bezpośrednimi połączeniami z ponad 800 przewoźnikami w ponad 200 krajach i terytoriach. Infobip obsługuje wszystkie typy nadawców, w tym krótkie kody, długie kody (wirtualne długie numery lub VLNs) i alfanumeryczne. Więcej informacji Jednokierunkowa obsługa komunikatów jest dostępna dla praktycznie wszystkich sieci we wszystkich krajach i terytoriach. Dwukierunkowa obsługa komunikatów jest dostępna w ponad 100 krajach. Pokrycie kraju Infobip oferuje elastyczny model cenowy płatności w miarę użytkowania dla wiadomości SMS. Wyświetl stawki. Aby uzyskać ceny dostosowane do Twoich potrzeb, skontaktuj się z działem sprzedaży.

Important

Partnerzy programu Messaging Connect są wybierani na podstawie globalnego zasięgu, wiedzy prawnej, niezawodności i silnej integracji z ekosystemem firmy Microsoft.

Dalsze kroki