Execute an API triggered campaign execute
Once your campaign has been activated, you need to retrieve the generated sample cURL request and use it into the API to build your payload and trigger the campaign.
Da leggere must-read
-
Campaign start/end dates - If you have configured a specific start and/or end date when creating the campaign, it will not be executed outside these dates, and API calls will fail.
-
Call timeout - The call to the Interactive Message Execution REST API has a timeout of 60 sec. However internal retries are in place in case of unexpected timeouts to guarantee the delivery.
Trigger the campaign trigger
-
Open the campaign, then copy-paste the payload request from the cURL request section. This payload includes all personalization (profile and context) variables used in the message. It is available once the campaign is live.
note important IMPORTANT The endpoints in the cURL section differ between standard and High throughput campigns. -
Use this cURL request into the APIs to build your payload and trigger the campaign. For more information, refer to the Interactive Message Execution API documentation, where all endpoints for standard and High throughput campaigns are listed.
API call examples are also available on this page.
Risoluzione dei problemi troubleshooting
Email delivery delays 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) cosmosdb-auth-errors
If you encounter 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”
This error typically occurs when the Azure service principal required for Cosmos DB authentication has been disabled, deleted, or misconfigured.
-
Verificare l’entità servizio Azure. Verificare che l’entità servizio Azure o l’identità gestita siano abilitate e non siano state disabilitate o eliminate in Azure Active Directory.
-
Verifica autorizzazioni - Verifica che l’entità servizio disponga delle autorizzazioni necessarie per accedere alle risorse Azure Key Vault e Cosmos DB. L’entità servizio deve disporre delle assegnazioni di ruolo appropriate per l’autenticazione con Azure Cosmos DB.
-
Controlla la configurazione della CMK di Azure Cosmos DB. Se utilizzi le chiavi gestite dal cliente (CMK), consulta la guida alla risoluzione dei problemi della CMK di Azure Cosmos DB per i passaggi dettagliati per ripristinare l’acquisizione del token AAD.
-
Riattiva e verifica - Dopo aver corretto la configurazione, riattiva l’entità servizio, se è stata disabilitata, e verifica nuovamente le chiamate API della campagna transazionale per verificare che l’autenticazione abbia esito positivo e che i messaggi vengano recapitati.
| note |
|---|
| NOTE |
| Questo problema è in genere causato da una configurazione errata o da una disabilitazione accidentale dell’entità principale del servizio Azure richiesta per l’autenticazione Cosmos DB. Se l'entità servizio viene mantenuta abilitata e configurata correttamente, l'errore non si verificherà più. |