Registre seu serviço no painel do desenvolvedor de emails acionáveis

As integrações que não foram atualizadas para usar tokens do Microsoft Entra ID não funcionam mais. Os parceiros devem usar a autenticação de token baseada em ID do Entra para todas as integrações do Actionable Messages. Para obter mais informações, consulte Habilitar o token do Microsoft Entra ID para Mensagens Acionáveis.

Para testar e publicar mensagens acionáveis do seu serviço, forneça determinadas informações à Microsoft para habilitar essa funcionalidade para emails do seu serviço. O dashboard do desenvolvedor ajuda você a enviar e acompanhar o status do seu envio por meio do portal da web.

Se você for um desenvolvedor que trabalha com mensagens acionáveis por email, use o portal para os seguintes casos:

• Para testar mensagens acionáveis do seu serviço para sua própria caixa de correio
• Para publicar mensagens acionáveis do seu serviço para que qualquer usuário de email em sua organização que use o Microsoft 365 possa receber essas mensagens formatadas especialmente. Essa opção normalmente permite mensagens acionáveis de um serviço específico para sua organização, como um aplicativo de linha de negócios.
• Para publicar mensagens acionáveis do seu serviço para que qualquer usuário de email no Microsoft 365 que use seu serviço possa receber essas mensagens especialmente formatadas

Para todos esses casos, envie os detalhes para a Microsoft. Após análise e aprovação, a Microsoft habilita mensagens acionáveis para seu serviço.

Seções do painel

O dashboard do desenvolvedor é dividido em algumas seções lógicas que você precisa preencher com base no escopo que você deseja solicitar à Microsoft para habilitar mensagens acionáveis do seu serviço.

Dados do provedor

Nesta seção, forneça os principais detalhes que permitem que o Microsoft 365 aceite emails com marcação do seu serviço, bem como URLs que os botões de ação nesses emails podem invocar.

Os principais campos são:

• Endereço de email do remetente: insira um ou mais endereços de email estáticos que correspondam ao serviço que envia emails com marcação de ação. Por exemplo, myservice@contoso.com.

• URLs de destino: insira um ou mais domínios que correspondam aos URLs que processam as ações. Sua URL de destino pode corresponder ao domínio de nível superior ou ao subdomínio do TLD. Elas precisam ser URLs habilitadas para HTTPS. Por exemplo, https://api.myservice.com.

• Chave pública: Se você planeja enviar mensagens acionáveis como Signed Card, especifique a chave pública que corresponde à chave privada que você usa para assinar o card. O formato deste campo é um elemento RSAKeyValue.

  <RSAKeyValue>
    <Modulus>xA7SEU+e0yQ...</Modulus>
    <Exponent>AQAB</Exponent>
  </RSAKeyValue>
  

Você pode gerar e exportar um par de chaves RSA no formato correto usando o PowerShell (7.3 ou posterior).

# Generate a key pair:
$rsa = [System.Security.Cryptography.RSA]::Create();

# Private Key, ensure this is saved securely and kept secret:
$rsa.ToXmlString($true)

## Public Key, copy output to dashboard:
$rsa.ToXmlString($false)

Para obter um exemplo de como obter XML de chave pública de um arquivo .cert, consulte a classe PublicKey.

Adaptive card signature validation failed - Failed to validate signature

Escopo do envio

Especifique o escopo em que você deseja habilitar a mensagem acionável para seu serviço. Os escopos aplicáveis são:

• Usuários de teste: esse escopo permite emails acionáveis do seu serviço para alguns dos usuários de email do Microsoft 365 em sua organização. Use este escopo para testar a integração de mensagens acionáveis com alguns usuários de teste que você especificar.
• Organização: esse escopo permite mensagens acionáveis do seu serviço para qualquer usuário de email do Microsoft 365 em sua organização. Use este escopo para habilitar mensagens acionáveis de um serviço específico para sua organização, como um aplicativo de linha de negócios.
• Global: esse escopo permite mensagens acionáveis do seu serviço para qualquer usuário de email no Microsoft 365.

Cada escopo é independente. Você pode enviar apenas um escopo por solicitação e deve obter a aprovação da Microsoft.

Registro de autoatendimento

O registro de autoatendimento está disponível para os seguintes escopos.

• Usuários de teste: a solicitação de registro é aprovada automaticamente para os usuários de teste que você especificar. Esse registro permite que emails acionáveis do seu serviço sejam enviados aos usuários de teste.
• Organização: essa solicitação de registro encaminha para o Exchange ou o Administrador global da sua organização para revisão e aprovação.

Depois que o envio for aprovado, seja aprovado automaticamente ou pelo administrador, pode levar até 24 horas para que o registro entre em vigor.

Após 24 horas, verifique se o registro está ativo enviando uma mensagem acionável do seu serviço para sua caixa de correio ou usuários de teste especificados (para o escopo Usuários de Teste ) ou qualquer usuário em sua organização (para o escopo da Organização ). Se 24 horas se passaram e o registro ainda não está ativo, entre em contato conosco usando o link de comentários na parte superior do dashboard de registro rotulado como O registro não está funcionando?.

Endereços de email de usuários de teste

Esta seção só é aplicável quando seu escopo de envio para permitir mensagens acionáveis é Usuários de teste.

Forneça uma lista de usuários de email do Microsoft 365 em sua organização, separados por ponto e vírgula (;). Esta lista ajuda você a testar a integração de mensagens acionáveis com alguns usuários antes de criar um envio de escopo global ou organização.

Informações de contato

Esta seção só é aplicável quando seu escopo de envio para a habilitação de mensagens acionáveis é Global.

Nesta seção, você precisará fornecer dados do contato, para podermos entrar em contato com você se tivermos mais perguntas sobre o envio. Todas as informações fornecidas devem ser válidas e corretas.

Informações do fornecedor

Esta seção só é aplicável quando seu escopo de envio para a habilitação de mensagens acionáveis é Global.

Nesta seção, você precisa fornecer dados sobre o serviço que enviará mensagens acionáveis e informações de apoio relacionadas, para que possamos entrar em contato com você ou encaminhar os clientes ao seu site de suporte. Essas informações também serão usadas como parte do processo de aprovação pela Microsoft para o seu provedor.

Dados do cenário

Esta seção só é aplicável quando seu escopo de envio para a habilitação de mensagens acionáveis é Global.

Nesta seção, você precisa fornecer detalhes sobre o cenário no qual os usuários usarão mensagens acionáveis do seu serviço. Isso ajuda a Microsoft a determinar a validade e a utilidade da solução.

Dados da verificação

Esta seção só é aplicável quando seu escopo de envio para a habilitação de mensagens acionáveis é Global.

Nesta seção, você precisa fornecer dados para que a Microsoft verifique a mensagem acionável e as ações correspondentes invocadas do email enviado pelo seu provedor/serviço.

Além disso, envie um email válido proveniente de seus servidores de produção (ou um servidor com cabeçalhos DKIM/SPF/From:/Return-Path: semelhantes), incluindo a marcação para onboardoam@microsoft.com. Esse procedimento permitirá que a Microsoft determine se a solução está em conformidade com todas as diretrizes e requisitos listados nos Critérios de Registro.

• Verifique se a marcação está correta antes de enviar o email.
• O Microsoft 365 remove todas as marcações ao encaminhar um email. Não encaminhe o email, envie-o diretamente.

Critérios de registro

Lembre-se desses critérios ao enviar sua solução para aprovação para escopo global , pois isso pode ter um amplo impacto sobre os usuários no Microsoft 365.

Diretrizes de qualidade para o remetente do email

• Autentique emails por meio de DKIM ou SPF.
• O domínio de topo (TLD) da verificação de SPF ou da assinatura DKIM deve corresponder ao TLD do seu endereço de email From:. Por exemplo, se você usar From: myservice@contoso.com, a DKIM ou SPF deve ser para contoso.com ou -.contoso.com.
• Enviar emails de um endereço de email estático, como myservice@contoso.com.
• Siga as diretrizes para enviar emails.
  • Para o Microsoft 365, consulte Serviços do Microsoft 365 para remetentes de email externos.
  • Para Outlook.com, consulte Políticas, práticas e diretrizes.
  • Para obter diretrizes do setor, consulte M3AAWG Sender Best Practices e ReturnPath Sending Best Practices.
• Mantenha um histórico consistente de envio de um grande volume de emails de seu domínio (um pedido mínimo de cem emails por dia para o Microsoft 365) por pelo menos algumas semanas.
• Manter uma taxa muito baixa de reclamações de spam dos usuários.
• Use ações de alta fidelidade, rotina e simples para o seu serviço. Para interações mais complexas, use Action.OpenUrl ações.
• Use ações para emails transacionais em que uma alta taxa de interação é esperada. Não os use em emails promocionais em massa.

Diretrizes para ações

• O rótulo do botão precisa refletir claramente a ação a ser tomada.
• Action.OpenUrl A ação deve ter um link profundo para a página específica associada à entidade ou às informações apresentadas na mensagem acionável.
• Mantenha uma baixa taxa de falhas e uma resposta rápida para serviços que lidam com solicitações de ação.
• Para obter diretrizes adicionais sobre como criar mensagens acionáveis, consulte Criando cartões de mensagem acionáveis do Outlook com o formato de Cartão Adaptável.

Aprovação do envio

Você receberá uma notificação no endereço de email fornecido durante o envio, portanto, certifique-se de fornecer as informações de contato corretas.