Eseguire una campagna attivata da API execute
Una volta attivata la campagna, devi recuperare la richiesta cURL di esempio generata e utilizzarla nell’API per generare il payload e attivare la campagna.
Da leggere must-read
-
Date di inizio/fine campagna - Se hai configurato una data di inizio e/o fine specifica durante la creazione della campagna, questa non verrà eseguita oltre queste date e le chiamate API avranno esito negativo.
-
Timeout chiamata - Il timeout della chiamata all'API REST di esecuzione messaggi interattiva è di 60 secondi. Tuttavia, in caso di timeout imprevisti per garantire la consegna, sono presenti nuovi tentativi interni.
Attivare la campagna trigger
-
Apri la campagna, quindi copia e incolla la richiesta di payload dalla sezione richiesta cURL. Questo payload include tutte le variabili di personalizzazione (profilo e contesto) utilizzate nel messaggio. È disponibile una volta che la campagna è in diretta.
note important IMPORTANT Gli endpoint nella sezione cURL differiscono tra le campagne standard e le campagne con throughput elevato. -
Utilizza questa richiesta cURL nelle API per generare il payload e attivare la campagna. Per ulteriori informazioni, consulta la documentazione dell'API di esecuzione interattiva dei messaggi, in cui sono elencati tutti gli endpoint per le campagne Standard e High Throughput.
Gli esempi di chiamate API sono disponibili anche in questa pagina.
Risoluzione dei problemi troubleshooting
Errori di autenticazione di Azure Cosmos DB (errore 500 del server interno) cosmosdb-auth-errors
Se durante l'attivazione di campagne attivate da API si verificano 500 errori interni del server e i registri di sistema mostrano un errore 403 Forbidden da Azure Cosmos DB con un messaggio di tipo:
"L'accesso all'account è attualmente revocato perché il servizio Azure Cosmos DB non è in grado di ottenere il token di autenticazione AAD per l'identità predefinita dell'account"
Questo errore si verifica in genere quando l’entità principale del servizio Azure richiesta per l’autenticazione Cosmos DB è stata disabilitata, eliminata o non configurata correttamente.
-
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 dell'insieme di credenziali delle chiavi di Azure e Cosmos DB. L’entità servizio deve disporre delle assegnazioni di ruolo appropriate per l’autenticazione con Azure Cosmos DB.
-
Rivedi la configurazione CMK di Azure Cosmos DB. Se utilizzi le chiavi gestite dal cliente (CMK), consulta la Guida alla risoluzione dei problemi 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 |
|---|
| NOTE |
| Questo problema è in genere causato da una configurazione errata o da una disabilitazione accidentale dell’entità 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ù. |