Costruire un Dynamic Data Flow in WhatsApp

Costruisci un Dynamic Data Flow WhatsApp in ChatMaxima con liste dipendenti a catena popolate in tempo reale dalla tua API, come Categoria-Prodotto o Medico-Data-Ora.

Panoramica

Un Dynamic Data Flow è un WhatsApp Flow le cui liste vengono popolate in tempo reale dalla tua API. Ogni passaggio è una lista e la scelta del cliente in un passaggio determina ciò che mostra il passaggio successivo. Il flow guida il cliente attraverso una catena di selezioni dipendenti.

Esempi tipici:

Sanità - Medico, poi Data disponibile, poi Fascia oraria disponibile.
E-commerce - Categoria, poi Prodotto.
Servizi - Filiale, poi Servizio, poi Membro dello staff.

A differenza del Form Builder, le opzioni non vengono inserite manualmente. Quando il cliente passa alla schermata successiva, WhatsApp chiama un endpoint sicuro di ChatMaxima, che chiama la tua API e restituisce la lista successiva. Nulla è preimpostato in modo fisso, quindi lo stesso flow funziona per qualsiasi catena di passaggi tu definisca.

Come funziona

Il cliente apre il flow e vede la lista del primo passaggio.
Effettua una selezione.
WhatsApp invia quella selezione all'endpoint cifrato di ChatMaxima.
ChatMaxima chiama la tua API per il passaggio successivo, passando le selezioni precedenti.
Appare la lista successiva. Questo si ripete fino alla schermata di riepilogo finale.

Prerequisiti

Prima di iniziare, assicurati di avere:

Un account WhatsApp connesso - un numero WhatsApp Cloud API collegato a ChatMaxima.
Un'API per ogni passaggio - un endpoint HTTPS che restituisce una lista JSON di opzioni.
La chiave di cifratura configurata - una configurazione una tantum per account WhatsApp, descritta di seguito.

Nota: I Dynamic Data Flow sono guidati da endpoint, quindi WhatsApp richiede una chiave di cifratura. Devi completare la configurazione della cifratura prima di poter salvare un dynamic flow.

Passaggio 1: Avvia un Dynamic Data Flow

Vai su Campagne, poi WhatsApp Flows e clicca su Crea flow.
Inserisci un Nome del flow e scegli una Categoria.
Imposta Tipo di flow su Dynamic Data Flow.

Il builder passa alla vista Dynamic Steps.

Passaggio 2: Configura la chiave di cifratura

Un Dynamic Data Flow chiama un endpoint di ChatMaxima per ogni schermata, e WhatsApp richiede che tale canale sia cifrato.

Nella scheda Cifratura endpoint, clicca su Configura chiave di cifratura.
ChatMaxima genera una coppia di chiavi RSA per l'account e carica automaticamente la chiave pubblica su Meta.

Questa è un'azione una tantum per account WhatsApp. Ogni dynamic flow su quell'account riutilizza la stessa chiave.

Passaggio 3: Aggiungi i passaggi

Ogni passaggio è una lista dipendente. Clicca su Aggiungi passaggio e compila l'editor del passaggio.

Campi del passaggio

Campo	Descrizione
Titolo del passaggio	L'intestazione della schermata, per esempio `Select a Category`
Chiave del passaggio	Un identificatore minuscolo, per esempio `category`, referenziato in seguito come `{category}`
Etichetta della lista	L'etichetta mostrata sopra la lista
Metodo HTTP	`GET` o `POST` per la chiamata API
URL API	L'endpoint che restituisce le opzioni di questo passaggio
Autenticazione	Nessuna, Bearer Token, Basic Auth o Custom Header

Passare le selezioni precedenti

Per far dipendere un passaggio successivo da uno precedente, inserisci la chiave del passaggio precedente nel suo URL API come segnaposto. ChatMaxima la sostituisce con la selezione del cliente in fase di esecuzione.

https://api.example.com/products?category={category}

In questo esempio, l'URL del passaggio product inserisce la category scelta.

Passaggio 4: Mappa la risposta dell'API

La sezione Mappatura risposta dell'editor del passaggio indica a ChatMaxima come leggere il JSON della tua API.

Campo	Descrizione
Percorso della lista	Percorso all'array nella risposta, per esempio `data`. Lascia vuoto se la risposta è già un array
Campo ID	Il campo usato come valore dell'opzione, per esempio `id`
Campo titolo	Il campo mostrato come testo principale dell'opzione, per esempio `name`
Campo descrizione	Una riga secondaria facoltativa, per esempio `price`

È supportata la notazione con punto per i campi annidati, come price.amount.

Passaggio 5: Salva e pubblica

Clicca su Salva Dynamic Flow. ChatMaxima genera le schermate del WhatsApp Flow dai tuoi passaggi e le carica.
Apri la bozza salvata e clicca su Pubblica.

La schermata finale è un riepilogo che ricapitola ogni selezione prima che il cliente confermi.

Best practice

Usa chiavi di passaggio chiare - brevi, minuscole e significative, poiché appaiono negli URL.
Restituisci liste brevi - le liste WhatsApp funzionano meglio con un insieme mirato di opzioni.
Ordina i passaggi dal generale allo specifico - per esempio Categoria prima di Prodotto.
Testa ogni API - conferma che ogni endpoint restituisca il JSON previsto prima di salvare.

Risoluzione dei problemi

Il salvataggio fallisce chiedendo la chiave di cifratura

Apri la scheda Cifratura endpoint.
Clicca su Configura chiave di cifratura e attendi la conferma.
Salva di nuovo il dynamic flow.

Un passaggio mostra una lista vuota

Controlla che l'URL API sia corretto e raggiungibile via HTTPS.
Verifica che Percorso della lista, Campo ID e Campo titolo corrispondano al JSON della tua API.
Conferma che qualsiasi {placeholder} nell'URL corrisponda alla chiave di un passaggio precedente.

Un passaggio non riesce a raggiungere l'API

L'API deve essere un endpoint HTTPS pubblico. Gli indirizzi interni o privati sono bloccati per ragioni di sicurezza.
Conferma che i dettagli di autenticazione siano corretti.