Flussi di Messaggistica WhatsApp - Passaggio "Connect APIs"

Con ActiveCampaign puoi usare il passaggio "Connect APIs" nei flussi di Messaggistica WhatsApp per collegare qualsiasi richiesta che supporti le richieste API. Questa funzionalità ti permette di estendere i tuoi flussi integrandoti con sistemi esterni, automatizzando i processi e recuperando o inviando dati. 

Questo articolo spiega lo step "API" e ti mostra alcuni esempi per illustrarne il potenziale.

Prendi nota

Questa opzione è pensata per utente avanzati. Devi sentirti a tuo agio con il codice. Il nostro team di Assistenza Clienti non può aiutarti a implementare o a risolvere problemi di codice.

Informazioni sul passaggio "Connect APIs"

Il passaggio "Connetti API" ti permette di fare richieste HTTP ad API esterne. Puoi configurare questo step per inviare o recuperare dati da altri sistemi, così da ottenere un’integrazione fluida tra ActiveCampaign e i tuoi strumenti esistenti.

Il passo API supporta vari metodi HTTP, tra cui GET, POST, PATCH, PUT e DELETE, e ti permette di personalizzare header, parametri di query e corpi della richiesta.

Configura il passaggio "Connect APIs"

1. Fai clic su WhatsApp > Messaging Flows nel menu a sinistra.
2. Modifica o crea un nuovo flusso di messaggi.
   • Se stai modificando un flusso, clicca su un flusso > Update > Steps. Fai clic su un nodo (+) nel builder dove vuoi inserire l’azione. Si aprirà una finestra modale. Fai clic sull'opzione "Connect APIs", poi fai clic sul pulsante "Add" 
   • Se stai creando un nuovo flusso, nel Flow builder verrà visualizzata una finestra modale. Fai clic sull"opzione "Connect APIs", poi fai clic sul pulsante "Add" 
3. Nel modale "Aggiungi passaggio" che viene visualizzato:
   • Fai clic sull’icona a forma di matita e dai un nome al tuo step. Ti consigliamo di usare nomi unici, brevi e descrittivi
   • Tipo di metodo - Seleziona il metodo HTTP appropriato in base al tuo caso d’uso
   • URL - Inserisci l'URL dell'endpoint API esterno a cui vuoi connetterti
   • Aggiungi gli header API necessari, come Body, Headers e Query. Se l’endpoint API richiede parametri di query, puoi aggiungerli qui. Per le richieste POST o PATCH, definisci l’oggetto JSON, il modulo o la stringa che verrà inviato come body della richiesta
   • Richiesta di test - Fai clic su questo pulsante per testare la connessione API
   • Attiva/disattiva la formattazione dei caratteri di escape nelle variabili - Se abilitata, i caratteri speciali nel testo della variabile verranno formattati

Esempi

Esempio 1: Invio di dati a un CRM

Supponiamo che tu voglia aggiornare le informazioni di un contatto nel tuo CRM ogni volta che completa un flusso in ActiveCampaign. Puoi usare il passaggio "Connect APIs" per inviare una richiesta POST all’API del CRM con i dati aggiornati del contatto. Per farlo:

1. Imposta l'URL del tuo CRM. Per esempio,  https://api.yourcrm.com/v1/contacts
2. Scegli POST come metodo HTTP - POST
3. Configura le intestazioni:

{
  "Authorization": "Bearer YOUR_API_KEY",
  "Content-Type": "richiesta/json"
}

4. Definisci il corpo della richiesta:

{
  "first_name": "{{contact.first_name}}",
  "last_name": "{{contact.last_name}}",
  "email": "{{contact.email}}",
  "phone": "{{contact.phone}}"
}

Esempio 2: recuperare dati da un sistema esterno

Immagina di dover recuperare lo storico degli ordini di un cliente da un sistema esterno e mostrarglielo in un flusso di Messaggistica WhatsApp. Puoi usare il passaggio "Connect APIs" per effettuare una richiesta GET all'API del sistema esterno, poi usare i dati recuperati nei passaggi successivi del flusso.

1. Imposta l'URL su: https://api.yourordersystem.com/v1/orders?user_id={{contact.id}}
2. Scegli GET come metodo HTTP
3. Configura le intestazioni:

{
  "Authorization": "Bearer YOUR_API_KEY"
}

La risposta dell’API può poi essere usata nel flusso per mostrare la cronologia degli ordini del cliente.

Esempio 3: Attivare un workflow esterno

Supponiamo che tu voglia attivare un workflow esterno ogni volta che un cliente completa uno specifico passaggio in un flusso WhatsApp. Puoi usare il passaggio "Connect APIs" per inviare una richiesta POST all'API di un sistema esterno, passando tutti i dati necessari.

1. Imposta l'URL su: https://api.yourworkflowtool.com/v1/trigger
2. Scegli POST come metodo HTTP
3. Configura le intestazioni:

"Authorization": "Bearer YOUR_API_KEY",
  "Content-Type": "richiesta/json"

4. Definisci il corpo della richiesta:

{
  "user_id": "{{contact.phone}}",
  "event": "flow_completed",
}