Sur cette page : récupérez la requête cURL générée et utilisez-la pour déclencher votre campagne en temps réel. Les conseils de dépannage vous aident à résoudre les retards de diffusion et les erreurs d’authentification.
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 temporisations inattendues 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
Retards de diffusion par e-mail delivery-delays
Si les délais de diffusion des e-mails dépassent les attentes, recherchez les pannes potentielles ou les problèmes de performances avec les services externes, tels que les fournisseurs d’infrastructure cloud ou les fournisseurs de messagerie électronique. Les journaux de Journey Optimizer enregistrent les dates et heures de départ des messages, ce qui peut aider à déterminer si des retards se sont produits en aval dans le pipeline de diffusion.
Erreurs d’authentification Azure cosmos DB (erreur de serveur interne 500) cosmosdb-auth-errors
Si vous rencontrez des erreurs de serveur interne 500 lors du déclenchement de campagnes déclenchées par API et que les journaux système affichent une erreur 403 Interdit provenant d’Azure Cosmos avec un message tel que :
« L’accès à votre compte est actuellement révoqué, car le service Azure Cosmos DB 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 Cosmos DB a été désactivé, supprimé ou mal configuré.
-
Vérifier votre principal de service Azure : assurez-vous que votre principal de service Azure ou que votre identité gérée sont activés et n’ont pas été désactivés ou supprimés dans 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 Cosmos DB. Le principal de service doit disposer des affectations de rôle appropriées pour s’authentifier auprès d’Azure Cosmos DB.
-
Vérifier la configuration de la CMK d’Azure Cosmos DB : si vous utilisez des clés gérées par le client ou la cliente (CMK), consultez le guide de dépannage de la CMK d’Azure Cosmos DB 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 bien diffusés.
| note |
|---|
| NOTE |
| Ce problème est généralement dû à une mauvaise configuration ou à une désactivation accidentelle du principal de service Azure requis pour l’authentification de Cosmos DB. Si le principal de service reste activé et correctement configuré, cette erreur ne se reproduira plus. |
This section contains structured knowledge intended to support interpretation, retrieval, and question answering related to this topic.
For complete understanding, this information should be combined with the documentation on this page. Neither source is intended to stand alone; the page describes the feature, while this section provides additional context that helps disambiguate terminology, intent, applicability, and constraints.
- TL;DR: This page explains how to retrieve the generated cURL request of an activated API triggered campaign and use it in the APIs to trigger the campaign, with troubleshooting for email delivery delays and Azure Cosmos DB authentication errors.
Intents:
- Retrieve the generated sample cURL request of a live API triggered campaign
- Use the cURL request in the APIs to build the payload and trigger the campaign
- Know that campaign start and end dates and a call timeout apply to the API call
- Find the endpoints for standard and High throughput campaigns
- Troubleshoot email delivery delays and 500 Internal Server Errors caused by Azure Cosmos DB authentication
Glossary:
- cURL request: Section of the campaign that holds the generated sample request; its payload includes all personalization (profile and context) variables used in the message
- Interactive Message Execution REST API: The API into which you use the cURL request to build your payload and trigger the campaign (product-specific)
- Azure service principal: The identity required for Azure Cosmos DB authentication (product-specific)
Guardrails:
- If a specific start and/or end date was configured when creating the campaign, the campaign is not executed outside these dates, and API calls fail.
- The call to the Interactive Message Execution REST API has a timeout of 60 sec. Internal retries are in place in case of unexpected timeouts to guarantee the delivery.
- The endpoints in the cURL section differ between standard and High throughput campaigns.
Prerequisites and permissions:
- The campaign must be activated: the cURL request is available once the campaign is live.
Applicability:
- Applies to API triggered campaigns, both standard and High throughput.
Terminology:
- Canonical name: Execute an API triggered campaign
- Acronym: CMK — Customer-Managed Keys (used on the page body)
FAQ:
- Q: Where do I find the request to trigger my campaign? — Open the campaign, then copy-paste the payload request from the cURL request section. It is available once the campaign is live.
- Q: What does the cURL payload contain? — All personalization (profile and context) variables used in the message.
- Q: Why do my API calls fail? — If a specific start and/or end date was configured when creating the campaign, it is not executed outside these dates, and API calls fail.
- Q: Where are the endpoints for standard and High throughput campaigns listed? — In the Interactive Message Execution API documentation.
- Q: Where can I find API call examples? — On the messaging samples page of the Journey Optimizer APIs documentation.
Troubleshooting:
- Email delivery delays — If email delivery times exceed expectations, investigate potential outages or performance issues with external services, such as cloud infrastructure providers or email service providers. Journey Optimizer logs record message departure timestamps, which can help determine whether delays occurred downstream in the delivery pipeline.
- Azure cosmos DB authentication errors (500 internal server error) — Symptom: 500 Internal Server Errors when triggering API-triggered campaigns, and the system logs show a 403 Forbidden error from Azure Cosmos DB with a message such as “Access to your account is currently revoked because the Azure Cosmos DB service is unable to obtain the AAD authentication token for the account’s default identity”. Cause: the Azure service principal required for Cosmos DB authentication has been disabled, deleted, or misconfigured. Documented resolution: verify that the Azure service principal or managed identity is enabled and has not been disabled or deleted in your Azure Active Directory; check that the service principal has the necessary permissions and role assignments to access the Azure Key Vault and Cosmos DB resources; if you are using Customer-Managed Keys (CMK), consult the Azure Cosmos DB CMK troubleshooting guide; after correcting the configuration, re-enable the service principal if it was disabled, and re-test your transactional campaign API calls to confirm that authentication succeeds and messages are delivered.
Related pages:
- Differences between standard and High throughput endpoints: High throughput campaigns (campaigns/api-triggered-high-throughput.md)
- All endpoints for standard and High throughput campaigns: Interactive Message Execution API documentation (https://developer.adobe.com/journey-optimizer-apis/references/messaging#tag/execution)
- API call examples: page linked as “this page”, messaging samples of the Journey Optimizer APIs documentation (https://developer.adobe.com/journey-optimizer-apis/references/messaging-samples)
- Azure Cosmos DB CMK errors: Azure Cosmos DB CMK troubleshooting guide (https://learn.microsoft.com/en-us/azure/cosmos-db/cmk-troubleshooting-guide#azure-active-directory-token-acquisition-error)