Conexão de mensagens

Introduction

Bem-vindo ao Messaging Connect, uma nova maneira de fornecer o Serviço de Mensagens Curtas (SMS) globalmente com os Serviços de Comunicação do Azure. Ele integra parceiros confiáveis para que você possa alugar números e atender aos requisitos regulatórios locais enquanto continua a usar os conhecidos Serviços de Comunicação do Azure: ponto de extremidade de API único, forte observabilidade e integração profunda entre os serviços da Microsoft. Quer esteja a enviar lembretes de compromissos, confirmações de reservas ou mensagens inteligentes com o Copilot, o Messaging Connect ajuda-o a alcançar utilizadores globalmente com menos complexidade.

Em vez de criar e manter integrações separadas com vários provedores, você se conecta uma vez por meio dos Serviços de Comunicação do Azure e roteia o tráfego para parceiros globais. A conformidade e o aluguer de números são geridos pelo parceiro. Os fluxos de trabalho de mensagens, observabilidade e IA permanecem dentro do seu ambiente do Azure, onde você já cria, monitora e dimensiona.

Valor em resumo:

• Alcance global em 190+ países

• Conformidade local e provisionamento mais rápido por meio de parceiros

• Simples de usar APIs/SDKs dos Serviços de Comunicação do Azure, diagnósticos e observabilidade da Grade de Eventos

• Separação de funções: a Microsoft fornece a plataforma de desenvolvimento; os parceiros entregam e provisionam números.

Visão Geral Conceitual

O SMS global é inerentemente complexo: os regulamentos diferem de acordo com o país, os tipos de remetente variam e as rotas de entrega são fragmentadas. O Messaging Connect integra parceiros pré-aprovados para que você possa adquirir identidades de remetente compatíveis e rotear o tráfego sem sair da experiência de desenvolvedor dos Serviços de Comunicação do Azure.

Fluxo de provisionamento (alto nível):

1. No portal do Azure, vá para a folha Messaging Connect

2. Selecione seu parceiro do Messaging Connect.

3. Você será redirecionado para o portal do parceiro para comprar/configurar números de telefone compatíveis com SMS, concluir todos os registros necessários e aguardar aprovação.

4. O parceiro sincroniza os números aprovados de volta ao seu recurso dos Serviços de Comunicação do Azure.

5. O número aparece no portal do Azure e está pronto para uso com as APIs SMS dos Serviços de Comunicação do Azure.

Você pode enviar e receber SMS usando as APIs de SMS padrão dos Serviços de Comunicação do Azure. Ao enviar mensagens, você se autentica com o Azure como de costume e inclui uma chave do seu parceiro do Messaging Connect em tempo de execução para que possamos rotear seu tráfego adequadamente. O parceiro lida com a entrega de mensagens, enquanto a observabilidade, como recibos de entrega, diagnósticos e registros, permanece no Azure com seus outros serviços.

Este modelo funciona bem em cenários do mundo real. Você pode usar o Messaging Connect para alcançar usuários em todo o mundo, seja criando um assistente alimentado por IA com o Copilot Studio, gerenciando a logística que exige IDs de remetente locais no Brasil e na Índia ou coordenando campanhas em dezenas de países. Os Serviços de Comunicação do Azure, por meio do Messaging Connect, permitem que você adquira as identidades de remetente corretas por meio de um parceiro confiável e as use com seu SDK de SMS dos Serviços de Comunicação do Azure preferido, mantendo total controle e observabilidade no Azure.

Capabilities

A tabela a seguir resume os recursos disponíveis ao usar o Messaging Connect durante a Visualização Pública. Alguns recursos são fornecidos diretamente pelo Azure, outros por parceiros do Messaging Connect.

🌐 Disponibilidade do país

O Messaging Connect expande significativamente o número de países que pode alcançar com os Serviços de Comunicação do Azure, suportando mais de 190 países através da nossa rede global de parceiros. Durante a Visualização Pública, você pode adquirir e usar dois tipos de identidades de remetente do Parceiro do Messaging Connect:

• Códigos longos – Números de telefone locais padrão ou números de celular que suportam SMS bidirecional. Muitas vezes conhecidos como códigos longos virtuais.
• IDs de Remetente Alfanumérico Dinâmico – Remetentes unidirecionais com marca (por exemplo, "CONTOSO") onde permitido. Você pode habilitar o DASID somente em países com suporte que não sejam os Serviços de Comunicação do Azure.

Quando procura um país e um tipo de número no portal do Azure, é-lhe oferecida a Ligação de Mensagens como uma opção se os Serviços de Comunicação do Azure não suportarem diretamente essa configuração. Em seguida, você conclui o processo de provisionamento por meio do portal do parceiro.

O parceiro Messaging Connect determina a disponibilidade do país. O parceiro do Messaging Connect (por exemplo, a Infobip) lida com tipos de número, requisitos de conformidade e etapas de integração, que variam de acordo com o país.

Autenticação: Acesso Seguro com a Identidade do Azure

Para enviar mensagens por meio do Messaging Connect, seu aplicativo deve se autenticar com os Serviços de Comunicação do Azure usando um dos modelos de identidade com suporte. Esta etapa verifica se seu aplicativo tem permissão para enviar mensagens por meio do recurso dos Serviços de Comunicação do Azure e garante que suas mensagens estejam associadas à assinatura correta do Azure.

Os Serviços de Comunicação do Azure dão suporte aos seguintes métodos de autenticação:

• Autenticação de chave de acesso (cadeias de conexão)
• Autenticação de ID do Microsoft Entra

Você se autentica com os Serviços de Comunicação do Azure da mesma forma que faria para qualquer outra solicitação SMS. O Messaging Connect não altera a forma como a autenticação funciona no nível da plataforma — ele simplesmente adiciona uma etapa de roteamento baseada em parceiro depois que sua mensagem é validada.

Saiba mais: Autenticar nos Serviços de Comunicação do Azure

Uma vez autenticado, seu aplicativo também inclui uma chave de API de parceiro em tempo de execução para rotear a mensagem através do parceiro Messaging Connect correto. Essa chave de API de parceiro faz parte da carga útil da mensagem e é explicada mais detalhadamente na próxima seção.

Como o Messaging Connect valida suas solicitações

Antes que uma mensagem possa ser enviada usando o Messaging Connect, o Azure verifica se sua solicitação contém as informações de roteamento necessárias e está autenticada corretamente. Para executar esta etapa, sua carga deve incluir metadados específicos que identifiquem o parceiro do Messaging Connect e permitam que os Serviços de Comunicação do Azure roteiem a mensagem por meio de sua infraestrutura.

Formato de carga útil necessário

Quando você envia uma mensagem usando um número do Messaging Connect, sua solicitação deve incluir um messagingConnect objeto. Este objeto contém a chave de API fornecida pelo parceiro do Messaging Connect (por exemplo, Infobip) e o nome do parceiro. O Azure usa essas informações para autorizar a solicitação e determinar como rotear a mensagem.

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

O messagingConnect objeto é necessário sempre que você usa um número provisionado por meio do Messaging Connect. Se estiver ausente ou configurado incorretamente, os Serviços de Comunicação do Azure rejeitarão a mensagem. Depois que esses metadados são incluídos, os Serviços de Comunicação do Azure executam verificações de validação em dois estágios: primeiro, os Serviços de Comunicação do Azure validam sua solicitação assim que ela é recebida e, em seguida, novamente depois de enviá-la ao parceiro.

Validação síncrona

Essa primeira camada de validação acontece assim que os Serviços de Comunicação do Azure recebem sua solicitação de mensagem. Se algo estiver faltando ou for inválido, como o nome do parceiro, a chave da API ou a associação entre o número e seu recurso dos Serviços de Comunicação do Azure, você receberá uma resposta de erro imediata. Essa verificação impede que as mensagens sejam enviadas incorretamente ou encaminhadas para o parceiro errado.

Resultados comuns da validação:

Esses erros retornam de forma síncrona em sua resposta de API e também aparecem nos logs e diagnósticos do Azure.

Erros de entrega assíncrona

Mesmo que sua solicitação passe na validação síncrona, os Serviços de Comunicação do Azure ainda podem não entregá-la ao parceiro do Messaging Connect. Em alguns casos, os Serviços de Comunicação do Azure interrompem a mensagem antes da entrega, por exemplo, se o destinatário tiver optado por não receber anteriormente ou se houver um bloco de entrega conhecido do parceiro. Essas situações ainda resultam em um relatório de entrega, para que você seja sempre informado do resultado da mensagem. Depois que uma mensagem é passada para o parceiro, quaisquer falhas de entrega downstream — como número inacessível, período de validade expirado ou rejeição no nível da operadora — também são retornadas de forma assíncrona por meio de relatórios de entrega. Você pode exibir status de entrega em seus relatórios de entrega de eventos da Grade de Eventos do Azure (se configurado).

Saiba mais: Relatórios de entrega em eventos da grade de eventos do Azure

Acesso global com mensagens seguras e compatíveis

O Messaging Connect foi concebido para utilização global, quer esteja a operar a partir da Ásia, África, América do Sul ou União Europeia. Esta seção explica como os dados fluem entre regiões, como a privacidade é mantida e como o Azure garante a conformidade com os requisitos de residência.

Roteamento de mensagens e fluxo de dados

O Messaging Connect separa a entrega de mensagens (manipulada pelo parceiro) do processamento e da observabilidade (manipulados pelo Azure). Veja como funciona:

• Mensagens de saída: você envia um SMS usando a API dos Serviços de Comunicação do Azure e inclui informações de roteamento de parceiro via messagingConnect objeto. O Azure registra a mensagem, executa a validação e a encaminha para o parceiro selecionado do Messaging Connect.
• Mensagens de entrada: o parceiro recebe o SMS e o encaminha para a infraestrutura do Azure. A partir daí, os Serviços de Comunicação do Azure lidam com a mensagem como qualquer outra enviada para números nativos dos Serviços de Comunicação do Azure, acionando eventos por meio da Grade de Eventos.

Embora o parceiro cuide da entrega, a Azure fornece:

• Recibos de entrega e observabilidade
• APIs e SDKs padrão dos Serviços de Comunicação do Azure
• Somente processamento transitório de mensagens — nenhum conteúdo de mensagem é armazenado

Os Serviços de Comunicação do Azure não retêm o conteúdo da mensagem SMS após a entrega ou falha. Mensagens e metadados são processados temporariamente na memória somente conforme necessário para roteamento e diagnóstico.

Saiba mais: Residência de dados e privacidade do usuário

Limite de dados da UE (EUDB)

Os Serviços de Comunicação Azure garantem que os dados SMS dentro da EUDB são armazenados nas regiões da EUDB. A partir de hoje, processamos e armazenamos dados nas regiões da Holanda, Irlanda ou Suíça, garantindo que não haja transferência de dados não autorizada para fora do EEE (Espaço Econômico Europeu). Além disso, a Azure Communication Services emprega medidas de segurança avançadas, incluindo criptografia, para proteger os dados SMS tanto em repouso quanto em trânsito. Os clientes podem selecionar sua residência de dados preferida dentro do EUDB, certificando-se de que os dados permaneçam nas regiões designadas da UE.

Saiba mais: Limite de dados da União Europeia (EUDB)

Usando o Messaging Connect de qualquer lugar

O Messaging Connect foi projetado para uso global. Depois de adquirir um número por meio de um parceiro do Messaging Connect, você o integra ao seu aplicativo usando APIs dos Serviços de Comunicação do Azure, independentemente de onde ele está hospedado. No entanto, alguns países aplicam regras de telecomunicações locais sobre o uso de números, tipos de conteúdo permitidos ou requisitos de originação de tráfego. O parceiro do Messaging Connect gerencia esses requisitos durante o processo de provisionamento de números. O parceiro, não os Serviços de Comunicação do Azure, otimiza as rotas de entrega. Dependendo do tipo de número, das regras locais e da configuração do parceiro, as mensagens podem ser encaminhadas através da infraestrutura local ou regional.

Gestão de cancelamento de subscrição

A conformidade com os processos de opt-out e opt-in é uma parte crítica das mensagens SMS, especialmente em mercados regulamentados. Com o Messaging Connect, essa responsabilidade é compartilhada entre você (o cliente), o parceiro (por exemplo, a Infobip) e a Microsoft, com cada um desempenhando um papel distinto.

Principais Responsabilidades

• O parceiro (por exemplo, a Infobip) suporta a deteção de palavras-chave de exclusão e aceitação, como "STOP" ou "START", mas o comportamento não é automático.

• Mensagens de confirmação como "você cancelou a inscrição" não são enviadas por padrão. Se desejar, você deve configurá-los explicitamente com o parceiro ou implementá-los em seu próprio aplicativo.
• Você, o cliente, é responsável por garantir que sua experiência de mensagens esteja em conformidade com as regulamentações locais, incluindo tratamento de exclusão, configuração de palavras-chave e gerenciamento de consentimento do usuário final.
• Os Serviços de Comunicação do Azure não processam palavras-chave de exclusão nem enviam respostas automatizadas. No entanto, a Microsoft mantém um conjunto de palavras-chave de exclusão predefinidas para observabilidade.

O que os Serviços de Comunicação do Azure fazem

Por padrão, os Serviços de Comunicação do Azure detetam palavras-chave Opt-in/out padrão: START e UNSTOP são reconhecidas como gatilhos Opt-In, enquanto STOP, ARRET, QUIT, END, REVOKE, OPT OUT, CANCEL e UNSUBSCRIBE são reconhecidos como comandos Opt-out. Quando uma mensagem de entrada corresponde exatamente a uma dessas palavras-chave, os Serviços de Comunicação do Azure processam automaticamente a solicitação e atualizam o status de aceitação do usuário em nosso banco de dados de acordo.

Preços e Faturação

O Messaging Connect usa um modelo de taxa dupla para separar o uso da plataforma da Microsoft dos serviços de entrega e locação do parceiro.

O que você paga à Microsoft

Você paga uma taxa de plataforma para usar as APIs e a infraestrutura dos Serviços de Comunicação do Azure para o Messaging Connect. Isso abrange processamento de mensagens, diagnóstico, rastreamento de entrega e observabilidade em nível de API.

• O Azure cobra uma taxa de plataforma de US$ 0,0025 por cada solicitação de envio de SMS enviada, independentemente de a mensagem ser entregue pelo parceiro. A Microsoft não cobra pela entrega.
• Esta taxa é elegível para Pré-pagamento do Azure (também conhecido como Compromisso Monetário) e para MACC (Compromisso de Consumo do Microsoft Azure) e aparece como parte da sua fatura normal do Azure.

O parceiro do Messaging Connect, não a Microsoft, lida com a entrega de mensagens.

O que você paga ao parceiro

Você paga diretamente ao parceiro do Messaging Connect por:

• Locação de números de telefone (mensal ou anual)
• Taxas de entrega por mensagem, que variam de acordo com o país e a rota

O parceiro define termos comerciais e níveis de suporte. Por padrão, o parceiro do Messaging Connect (por exemplo, a Infobip) cobra diretamente as taxas de entrega e locação de números. Essas cobranças não aparecem na sua fatura do Azure, a menos que você configure explicitamente a cobrança do Marketplace. Não existem restrições de subscrição. Você pode usar o Messaging Connect com qualquer tipo de assinatura do Azure, incluindo Pay-as-you-go e Enterprise Agreements. Ao contrário das ofertas diretas de SMS da Microsoft, o Messaging Connect não é um serviço de telecomunicações — é um modelo de plataforma de desenvolvedor.

Opcional: Faturação consolidada através do Azure Marketplace

Se preferir consolidar os encargos na sua fatura do Azure, pode solicitar que o parceiro ofereça o Messaging Connect através do Azure Marketplace. Veja como funciona o fluxo do Marketplace:

1. Você pede ao parceiro (Infobip) para enviar uma oferta privada por meio do Azure Marketplace.
2. Seu administrador do Azure aceita a oferta no portal do Azure.
3. Todos os meses, o parceiro envia dados de utilização para a Microsoft.
4. A Microsoft cobra você em nome do parceiro (uma taxa de passagem).

Essa configuração simplifica a aquisição e permite que o uso do Messaging Connect conte para seu compromisso MACC do Azure.

Saiba mais: Azure Marketplace

Experiência do desenvolvedor

Obter um número de telefone com o Messaging Connect

O Messaging Connect apresenta um novo modelo de provisionamento: em vez de obter números diretamente da Microsoft, você os adquire por meio de um parceiro confiável, começando com a Infobip, e os conecta ao seu recurso dos Serviços de Comunicação do Azure. Esse processo permite que você acesse números de SMS em mais de 190 países, enquanto o parceiro lida com a conformidade, documentação e fluxos de aprovação locais.

Vamos passo a passo:

1. Escolha o seu parceiro do Messaging Connect

   No portal do Azure, no recurso Serviços de Comunicação, vá para a folha Messaging Connect e escolha um parceiro na lista. Aceite os termos. Você será redirecionado para o site do parceiro para concluir a aquisição do número.

2. Adquira o número no portal do parceiro

   Para comprar o número, siga as instruções fornecidas pelo parceiro do Messaging Connect. Dependendo do país, poderá ter de carregar documentos comprovativos ou concluir a verificação de identidade. Uma vez aprovado, o número é atribuído à sua conta de parceiro.

   

3. Regressar ao portal do Azure

   Quando o parceiro confirma que seus números estão provisionados, ele aciona a sincronização com os Serviços de Comunicação do Azure. Após a conclusão da sincronização, os números aparecem automaticamente no recurso ACS — prontos para uso com a API SMS DO ACS, assim como qualquer número provisionado diretamente por meio dos Serviços de Comunicação do Azure. Nenhuma configuração extra é necessária do seu lado.

   

   Note

   O parceiro do Messaging Connect define o cronograma de aprovação e ativação, que varia de acordo com o país e o tipo de número. Atualmente, o Messaging Connect não oferece suporte ao provisionamento instantâneo e a Microsoft não está envolvida no processo de verificação ou aprovação.

Observações importantes:

• A Microsoft não gerencia a conformidade ou a verificação de números do Messaging Connect. O parceiro trata inteiramente deste processo.
• Cada parceiro tem diferentes fluxos de provisionamento e acordos de nível de serviço (SLAs), dependendo da região e das regulamentações locais de telecomunicações.
• Os números adquiridos por meio do Messaging Connect aparecem no portal do Azure com um rótulo "Nome do operador" para que você possa distingui-los dos números gerenciados pelos Serviços de Comunicação do Azure.
• Para enviar mensagens com esses números, não se esqueça de incluir o MessagingConnect objeto em sua solicitação de API.

SMS SDK Tutorial

O Messaging Connect baseia-se nos recursos de SMS existentes dos Serviços de Comunicação do Azure. Ele usa as mesmas APIs e SDKs de SMS, portanto, se já estás familiarizado com o envio de mensagens usando o ACS, especialmente se concluíste o Guia de Início Rápido Enviar SMS, já quase concluíste. Apenas certifique-se de usar o Send SMS with options método e incluir o MessagingConnect objeto no campo de opções.

Se você é novo nos Serviços de Comunicação do Azure, comece concluindo o Guia de início rápido Enviar SMS para configurar a autenticação, criar seu SmsCliente entender a estrutura básica de uma solicitação de envio. Certifique-se de incluir o MessagingConnect objeto em sua solicitação.

Este objeto contém:

• O nome do parceiro (por exemplo, "infobip")
• A chave de API do parceiro que você recebeu depois de adquirir o número

Seu token dos Serviços de Comunicação do Azure continua a autorizar a solicitação para o Azure, e a chave de parceiro informa aos Serviços de Comunicação do Azure como rotear a mensagem.

Os exemplos a seguir mostram como enviar uma mensagem com o Messaging Connect usando C# e JavaScript.

Exemplo em 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")
    });

Exemplo de 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"
      }
  });

Códigos de erro SMS

Ao enviar mensagens SMS por meio do Messaging Connect, você pode encontrar códigos de erro — como parte da validação síncrona (resposta imediata da API) ou em relatórios de entrega assíncronos. Os Serviços de Comunicação do Azure usam o mesmo modelo de erro em todo o tráfego de SMS, incluindo o Messaging Connect.

Saiba mais: Veja a lista completa de códigos de erro SMS

Diretório de parceiros do Messaging Connect

O Messaging Connect funciona por meio de integrações diretas com provedores globais confiáveis de SMS. Esses parceiros lidam com o provisionamento de números, conformidade, entrega e controlo de exclusão, enquanto o Azure fornece a plataforma de desenvolvimento, a capacidade de observação e a orquestração de mensagens. A tabela a seguir lista os parceiros atualmente suportados. Mais parceiros serão adicionados ao longo do tempo para fornecer uma cobertura mais ampla e redundância.

Próximas Etapas