Conectar-se a mensagens

Introduction

Bem-vindo ao Messaging Connect, uma nova maneira de fornecer SMS (Serviço de Mensagem Curta) 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 regulamentares locais enquanto continua a usar os Serviços de Comunicação do Azure: único ponto de extremidade de API, forte observabilidade e integração profunda entre os serviços Microsoft. Se você estiver enviando lembretes de compromisso, confirmações de reserva ou prompts inteligentes do Copilot, o Messaging Connect ajuda você a alcançar usuários 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. O parceiro lida com locação de números e conformidade. Os fluxos de trabalho de mensagens, observabilidade e IA permanecem dentro do ambiente do Azure em que você já cria, monitora e dimensiona.

Visão geral do valor

• Alcance global em mais de 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óstico e observabilidade da Grade de Eventos

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

Visão geral conceitual

O SMS global é inerentemente complexo: as regulamentações diferem por 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 remetentes 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 o painel de Conexão de Mensagens

2. Selecione seu parceiro do Messaging Connect.

3. Você é redirecionado ao 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 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 de 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 parceiro do Messaging Connect em runtime para que possamos rotear seu tráfego adequadamente. O parceiro é responsável pela entrega das mensagens, enquanto a observabilidade, como recibos de entrega, diagnósticos e logs, permanece no Azure com seus outros serviços.

Esse 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 de 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 use-as com seu SDK de SMS dos Serviços de Comunicação do Azure preferido, mantendo o controle total e a 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 você pode alcançar com os Serviços de Comunicação do Azure, dando suporte a mais de 190 países por meio de nossa rede de parceiros global. Durante a Visualização Pública, você pode adquirir e usar dois tipos de identidades de remetente do Parceiro de Conexão de Mensagens:

• Códigos Longos – Números de telefone locais padrão ou números de celular que dão suporte a SMS bidirecional. Geralmente conhecidos como Virtual Long Codes.
• IDs de Remetente Alfanuméricos Dinâmicos – Remetentes unidirecionais e com marca (por exemplo, "CONTOSO"), onde permitido. Você pode habilitar o DASID somente em países sem suporte dos Serviços de Comunicação do Azure.

Quando você pesquisa um país e um tipo de número no portal do Azure, você recebe o Messaging Connect como uma opção se os Serviços de Comunicação do Azure não dão suporte diretamente a essa configuração. Em seguida, conclua o processo de provisionamento por meio do portal do parceiro.

O parceiro do Messaging Connect determina a disponibilidade do país. O parceiro do Messaging Connect (por exemplo, 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: Proteger o acesso 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 do Microsoft Entra ID

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

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

Depois de autenticado, seu aplicativo também inclui uma chave de API do parceiro em tempo de execução para rotear a mensagem pelo parceiro correto do Messaging Connect. Essa chave de API do parceiro faz parte do conteúdo da mensagem e é explicada ainda mais 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 é autenticada corretamente. Para executar essa etapa, seu conteúdo deve incluir metadados específicos que identificam o parceiro do Messaging Connect e permite 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. Esse 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 ele 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 realizam 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 após 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 ausente ou inválido, como o nome do parceiro, a chave de API ou a associação entre o número e o 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 roteadas para o parceiro errado.

Resultados comuns de validação:

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

Erros de entrega assíncronos

Mesmo que sua solicitação passe na validação síncrona, os Serviços de Comunicação do Azure ainda poderão 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 transferência—por exemplo, se o destinatário anteriormente optou por não receber mensagens ou se há um bloqueio de entrega conhecido do parceiro. Essas situações ainda resultam em um relatório de entrega, portanto, você 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 é criado para uso global, quer você esteja operando 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). Aqui está como isso 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 parceiros por meio do messagingConnect objeto. O Azure registra a mensagem, executa a validação e, em seguida, encaminha-a para o parceiro do Messaging Connect selecionado.
• 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 manipulam a mensagem como qualquer uma enviada a números nativos dos Serviços de Comunicação do Azure, acionando eventos por meio da Grade de Eventos.

Embora o parceiro manipule a entrega, o 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

Fronteira de Dados da UE (EUDB)

Os Serviços de Comunicação do Azure garantem que os dados de SMS dentro da EUDB sejam armazenados em regiões da EUDB. A partir de hoje, processamos e armazenamos dados nas regiões Dos Países Baixos, Irlanda ou Suíça, garantindo que não haja transferência de dados não autorizada fora da EEE (Área Econômica Europeia). Além disso, os Serviços de Comunicação do Azure empregam medidas de segurança avançadas, incluindo criptografia, para proteger dados SMS em repouso e em trânsito. Os clientes podem selecionar sua residência de dados preferencial dentro do EUDB, certificando-se de que os dados permaneçam dentro das 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, integre-o ao aplicativo usando APIs dos Serviços de Comunicação do Azure, independentemente de onde ele esteja hospedado. No entanto, alguns países impõem regras locais de telecomunicações sobre o uso de números, tipos de conteúdo permitidos ou requisitos de origem 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 roteadas por meio da infraestrutura local ou regional.

Gerenciamento de recusa

A conformidade com as regras de recusa e aceitação é uma parte essencial das mensagens SMS, especialmente em mercados regulamentados. Com o Messaging Connect, essa responsabilidade é compartilhada entre você (o cliente), o parceiro (por exemplo, Infobip) e a Microsoft, com cada um desempenhando uma função distinta.

Principais responsabilidades

• O parceiro (por exemplo, Infobip) dá suporte à detecção de palavras-chave de recusa e aceitação, como "STOP" ou "START", mas o comportamento não é automático.

• Mensagens de confirmação como "você não está inscrito" 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 recusa, configuração de palavra-chave e gerenciamento de consentimento do usuário final.
• Os Serviços de Comunicação do Azure não processam palavras-chave de recusa ou 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 detectam palavras-chave padrão de aceitação/saída: START e UNSTOP são reconhecidos como gatilhos de 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 cobrança

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 dos Serviços de Comunicação do Azure e a infraestrutura para o Messaging Connect. Isso abrange processamento de mensagens, diagnóstico, acompanhamento de entrega e observabilidade no nível da API.

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

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

O que você paga ao parceiro

Você paga diretamente ao parceiro do Messaging Connect por:

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

O parceiro define os termos comerciais e os níveis de suporte. Por padrão, o parceiro do Messaging Connect (por exemplo, Infobip) cobra você diretamente pelas taxas de entrega e locação de números. Esses encargos não aparecem na fatura do Azure, a menos que você configure explicitamente a cobrança do Marketplace. Não há restrições de assinatura. Você pode usar o Messaging Connect com qualquer tipo de assinatura do Azure, incluindo Pagamento conforme o uso e Contratos Empresariais. 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 para desenvolvedores.

Opcional: cobrança consolidada por meio do Azure Marketplace

Se preferir consolidar os encargos em sua fatura do Azure, solicite que o parceiro ofereça o Messaging Connect por meio 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. O administrador do Azure aceita a oferta no portal do Azure.
3. Todos os meses, o parceiro envia dados de uso para a Microsoft.
4. A Microsoft cobra em seu nome (uma cobrança de passagem).

Essa configuração simplifica a aquisição e permite que o uso do Messaging Connect conte para o compromisso do 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 pelo Infobip, e os conecta ao 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 local, a documentação e os fluxos de aprovação.

Vamos passo a passo:

1. Escolha seu Parceiro de Conexão de Mensagens

   No portal do Azure, em seu recurso dos Serviços de Comunicação, vá para a folha Conexão de Mensagens e escolha um parceiro na lista. Aceite os termos. Você será redirecionado para o site do parceiro para concluir a aquisição de números.

2. Adquirir o número no portal do parceiro

   Para comprar o número, siga os prompts fornecidos pelo parceiro do Messaging Connect. Dependendo do país, talvez seja necessário carregar documentos de suporte ou concluir a verificação de identidade. Depois de aprovado, o número é atribuído à sua conta de parceiro.

   

3. Retornar ao portal do Azure

   Depois que o parceiro confirmar que seus números estão provisionados, eles disparam a sincronização com os Serviços de Comunicação do Azure. Depois que a sincronização for concluída, os números serão exibidos automaticamente no recurso do ACS, pronto para uso com a API de 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 da sua parte.

   

   Note

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

Notas importantes:

• A Microsoft não gerencia a conformidade nem a verificação de números do Messaging Connect. O parceiro cuida integralmente desse processo.
• Cada parceiro tem fluxos de provisionamento diferentes e SLAs (contratos de nível de serviço), 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 você já estiver familiarizado com o envio de mensagens usando o ACS, especialmente se tiver concluído o Início Rápido do Envio de SMS, você estará quase lá. Apenas certifique-se de usar o Send SMS with options método e incluir o MessagingConnect objeto no campo de opções.

Se você não estiver familiarizado com os Serviços de Comunicação do Azure, comece concluindo o Início Rápido de Envio de SMS para configurar a autenticação, criar sua 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

O token dos Serviços de Comunicação do Azure continua autorizando 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 de 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, seja como parte da validação síncrona (resposta imediata à 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 de SMS

Diretório de Parceiros do Messaging Connect

O Messaging Connect funciona por meio de integrações diretas com provedores de SMS globais confiáveis. Esses parceiros lidam com provisionamento de números, conformidade, entrega e imposição de desativação, enquanto o Azure fornece a plataforma para desenvolvedores, a observabilidade e a orquestração de mensagens. A tabela a seguir lista os parceiros com suporte no momento. Mais parceiros serão adicionados ao longo do tempo para fornecer cobertura e redundância mais amplas.

Próximas etapas