Exécuter une campagne déclenchée par API execute
Une fois votre campagne activée, vous devez récupérer l’exemple de requête cURL généré et l’utiliser dans l’API pour créer votre payload et déclencher la campagne.
À lire impérativement must-read
-
Dates de début/de fin de la campagne : si vous avez configuré une date de début et/ou de fin spécifique lors de la création de la campagne, elle ne sera pas exécutée en dehors de ces dates et les appels API échoueront.
-
Délai d’expiration de l’appel : le délai d’expiration de l’appel de l’API REST Interactive Message Execution est de 60 secondes. Cependant, de nouvelles tentatives internes d’appel sont implémentées en cas de délais dépassés inattendus pour garantir la diffusion.
Déclencher la campagne trigger
-
Ouvrez la campagne, puis copiez-collez la requête de payload depuis la section requête cURL. Cette payload inclut toutes les variables de personnalisation (profil et contexte) utilisées dans le message. Elle est disponible une fois la campagne activée.
note important IMPORTANT Les points d’entrée de la section cURL diffèrent entre les campagnes standard et à débit élevé. -
Utilisez cette requête cURL dans les API pour créer votre payload et déclencher la campagne. Pour plus d’informations, consultez la documentation de l’API Interactive Message Execution, où tous les points d’entrée des campagnes standard et à débit élevé sont répertoriés.
Des exemples d’appels API sont également disponibles sur cette page.
Résolution des problèmes troubleshooting
Erreurs d’authentification Azure Cosmos DB (erreur de serveur interne 500) cosmosdb-auth-errors
Si vous rencontrez des erreurs de serveur internes 500 lors du déclenchement de campagnes déclenchées par l’API, et les journaux système affichent une erreur 403 Forbidden de la base de données Azure Cosmos avec un message tel que :
« L’accès à votre compte est actuellement révoqué, car le service de base de données Azure Cosmos ne parvient pas à obtenir le jeton d’authentification AAD pour l’identité par défaut du compte »
Cette erreur se produit généralement lorsque le principal de service Azure requis pour l’authentification de la BD Cosmos a été désactivé, supprimé ou mal configuré.
-
Vérifier votre principal de service Azure - Assurez-vous que votre principal de service Azure ou votre identité gérée est activé et n’a pas été désactivé ou supprimé dans votre Azure Active Directory.
-
Vérifier les autorisations - Vérifiez que le principal de service dispose des autorisations nécessaires pour accéder aux ressources Azure Key Vault et de la base de données Cosmos. Le principal de service doit avoir des affectations de rôle appropriées pour s’authentifier avec la base de données Azure Cosmos.
-
Vérification de la configuration de la fonction CMK de la base de données Azure Cosmos - Si vous utilisez des clés gérées par le client (CMK), consultez le guide de dépannage de la fonction CMK de la base de données Azure Cosmos pour obtenir des instructions détaillées sur la restauration de l’acquisition des jetons AAD.
-
Réactiver et tester - Après avoir corrigé la configuration, réactivez le principal de service s’il a été désactivé, puis testez à nouveau vos appels API de campagne transactionnelle pour confirmer que l’authentification réussit et que les messages sont diffusés.
| note note |
|---|
| NOTE |
| Ce problème est généralement causé par une mauvaise configuration ou une désactivation accidentelle du principal de service Azure requis pour l’authentification de la base de données Cosmos. Si le principal de service reste activé et correctement configuré, cette erreur ne se reproduira plus. |