Executar uma campanha acionada por API execute
Depois que sua campanha for ativada, é necessário recuperar a solicitação de cURL de amostra gerada e usá-la na API para criar sua carga e acionar a campanha.
Leitura obrigatória must-read
-
Datas de início/término da campanha - Se você tiver configurado uma data de início e/ou término específica ao criar a campanha, ela não será executada fora dessas datas, e as chamadas de API falharão.
-
Tempo limite de chamada - A chamada para a API REST de Execução de Mensagem Interativa tem um tempo limite de 60 segundos. No entanto, tentativas internas estão em vigor no caso de tempos limite inesperados para garantir o delivery.
Acionar a campanha trigger
-
Abra a campanha e copie e cole a solicitação de carga da seção cURL request. Essa carga inclui todas as variáveis de personalização (perfil e contexto) usadas na mensagem. Ele fica disponível assim que a campanha é ativada.
note important IMPORTANT Os pontos de extremidade na seção cURL diferem entre as campanhas padrão e de alta taxa de transferência. -
Use essa solicitação de cURL nas APIs para criar sua carga e acionar a campanha. Para obter mais informações, consulte a documentação da API de Execução de Mensagens Interativas, onde todos os pontos de extremidade para campanhas padrão e de Alta Taxa de Transferência são listados.
Exemplos de chamadas de API também estão disponíveis em esta página.
Solução de problemas troubleshooting
Erros de autenticação do Azure Cosmos DB (Erro interno 500 do servidor) cosmosdb-auth-errors
Se você encontrar 500 Erros Internos do Servidor ao acionar campanhas acionadas por API, e os logs do sistema mostrarem um erro 403 Proibido do BD do Azure Cosmos com uma mensagem como:
"O acesso à sua conta está revogado no momento porque o serviço Azure Cosmos DB não pode obter o token de autenticação AAD para a identidade padrão da conta"
Normalmente, esse erro ocorre quando a entidade de serviço do Azure necessária para a autenticação do Cosmos DB foi desabilitada, excluída ou configurada incorretamente.
-
Verifique a entidade de serviço do Azure - Verifique se a entidade de serviço do Azure ou a identidade gerenciada está habilitada e não foi desabilitada ou excluída no Azure Ative Diretory.
-
Verificar permissões - Confirme se a entidade de serviço tem as permissões necessárias para acessar os recursos do Cofre de Chaves do Azure e do Cosmos DB. A entidade de serviço deve ter atribuições de função apropriadas para autenticar com o Azure Cosmos DB.
-
Revise a configuração do CMK do Azure Cosmos DB - Se estiver usando as Chaves Gerenciadas pelo Cliente (CMK), consulte o guia de solução de problemas do CMK do Azure Cosmos DB para obter etapas detalhadas sobre como restaurar a aquisição do token AAD.
-
Reabilitar e testar - Depois de corrigir a configuração, habilite novamente a entidade de serviço, se ela estiver desabilitada, e teste novamente suas chamadas de API de campanha transacional para confirmar se a autenticação foi bem-sucedida, e se as mensagens foram entregues.
| note note |
|---|
| NOTE |
| Normalmente, esse problema é causado por uma configuração incorreta ou desabilitação acidental da entidade de serviço do Azure necessária para a autenticação do Cosmos DB. Manter a entidade de serviço habilitada e configurada corretamente evitará esse erro no futuro. |