Webhook
Marketo consente l’utilizzo di webhook per comunicare con servizi web di terze parti. I webhook supportano l’utilizzo dei verbi HTTP GET o POST per inviare o recuperare dati da un URL specifico. Per istruzioni dettagliate sulla creazione di webhook all’interno dell’applicazione e su come aggiungerli alle campagne intelligenti, consulta i seguenti articoli:
Ogni singolo webhook ha le seguenti proprietà:
- URL - Immettere l'URL da utilizzare per inviare la richiesta al servizio Web.
- Request Type - Metodo HTTP.
- Payload Template - Se si desidera trasmettere informazioni nel corpo del POST, immettere il modello. Utilizza qualsiasi formato di dati che supporta HTTP POST, inclusi XML, JSON o SOAP. Il formato di serializzazione deve consentire virgolette doppie attorno alle stringhe. Per inserire un token nel modello, fare clic su Insert Token. I token di tipo stringa vengono automaticamente racchiusi tra virgolette doppie.
- Request Token Encoding - Se i valori del token includono caratteri speciali (ad esempio una e commerciale, '&'), indica il formato della richiesta (JSON o Form/Url). È necessario selezionare la codifica corretta per il corpo per garantire che il webhook comunichi correttamente con il servizio Web.
- Response Type - Selezionare il formato della risposta ricevuta dal servizio (JSON o XML). È necessario selezionare il tipo di risposta corretto per mappare le proprietà della risposta ai campi lead in Marketo
- Custom Headers - Accesso tramite Webhooks Actions -> Set Custom Header, questo menu consente l'aggiunta di un numero qualsiasi di coppie chiave-valore personalizzate come intestazioni HTTP.
I dati possono essere scritti ai lead dalle risposte ai servizi Web utilizzando Mappature risposte
Token
Tutti i campi in uscita in un webhook (URL, modello e intestazioni personalizzate) popolano il contenuto dei token nello stesso contesto del passaggio di flusso. Ciò significa che i token di lead e di sistema sono sempre disponibili, mentre i token di trigger, Campaign e Program sono disponibili nei rispettivi ambiti. Consulta gli articoli relativi ai token:
Un caso comune si verifica quando un programma o una campagna sono mappati in modo esplicito a una risorsa di terze parti. Un ID può essere impostato a livello di programma come My Token e quindi passato nella richiesta Webhook come token.
Intestazioni personalizzate
I webhook consentono l’utilizzo di un numero qualsiasi di campi di intestazione personalizzati da inviare insieme alla richiesta in uscita. Possono essere aggiunte tramite Webhooks Actions > Set Custom Header. Ogni intestazione viene registrata come una semplice coppia chiave-valore. In quest’area è possibile utilizzare i token.
Suggerimenti
- Il passaggio Flusso del webhook di chiamata è valido solo nelle campagne Trigger.
- Gli aggiornamenti tramite i mapping di risposta si verificano solo se il servizio web risponde con un codice di risposta HTTP 2xx. Altri tipi di codici non comporteranno aggiornamenti del record.
- È possibile utilizzare i servizi Web per eseguire l'arricchimento, la convalida o la normalizzazione dei dati personalizzati da servizi interni o esterni.
- Il tempo di esecuzione del webhook è in balia del tempo di risposta del servizio utilizzato e può causare lunghi ritardi nell’esecuzione della campagna. Anche se l’esecuzione di un servizio richiede solo 50 ms, ovvero 1,5 ore se eseguito 100.000 volte.
- Marketo attende fino a 30 secondi per una determinata chiamata del servizio prima di terminare la chiamata (ovvero per timeout).
- I caratteri incorporati nel campo URL vengono passati come scritti. Ad esempio '&' viene inviato come '&', '%26' viene inviato come '%26'
- Se un carattere deve essere codificato in percentuale quando viene ricevuto dal server destinatario, deve essere passato esplicitamente come stringa che rappresenta tale carattere