Creazione e modifica WhatsApp dei flussi

Puoi creare un WhatsApp Flow utilizzando la console AWS End User Messaging Social o l'API AWS End User Messaging Social. Quando crei un Flow, viene impostato lo stato DRAFT. Facoltativamente, puoi fornire una definizione JSON di Flow al momento della creazione o aggiungerla in un secondo momento utilizzando l'operazione di aggiornamento delle risorse.

Creazione di un Flow (console)

1. Apri la console AWS End User Messaging Social all'indirizzo https://console.aws.amazon.com/social-messaging/.

2. Scegli un account aziendale, quindi scegli un WABA.

3. Scegli la scheda Flussi.

4. Scegliere Create flow (Crea flusso).

5. Per il nome Flow, inserisci un nome univoco per il tuo Flow. I nomi dei flussi devono essere univoci all'interno del WABA (massimo 200 caratteri).

6. Per Categoria, seleziona una o più categorie che descrivono lo scopo commerciale del tuo Flow. È richiesta almeno una categoria. Le categorie disponibili sono:

   • Registrazione

   • Accedi

   • Prenotazione di appuntamenti

   • Generazione di lead

   • Contattaci

   • Supporto clienti

   • Sondaggio

   • Acquisti

   • Altro

7. Per Template, scegli un modello predefinito da cui iniziare oppure scegli Predefinito per iniziare con un Flow vuoto. I seguenti modelli sono disponibili senza un endpoint:

   • Predefinito: un modello iniziale vuoto

   • Raccogli interessi all'acquisto: raccogli informazioni dai potenziali acquirenti

   • Ottieni feedback: raccogli il feedback dei clienti

   • Invia un sondaggio: crea un sondaggio con più domande

   • Assistenza clienti: raccogli i dettagli della richiesta di assistenza

8. Scegli Create (Crea).

Dopo aver creato Flow, puoi modificare Flow JSON per personalizzare schermate e componenti. L'anteprima di Flow sul lato destro della pagina mostra un'anteprima dal vivo di come il tuo Flow apparirà agli utenti in WhatsApp.

Creazione di un flusso (API)

Usa l'CreateWhatsAppFlowAPI per creare un nuovo Flow. L'esempio seguente utilizza AWS CLI per creare un flusso con un nome e una categoria:

aws socialmessaging create-whatsapp-flow \
    --id {WABA_ID} \
    --flow-name "my_lead_generation_form" \
    --categories '["LEAD_GENERATION"]'

La risposta include l'ID Flow assegnato da Meta:

{
    "flowId": "{FLOW_ID}",
    "validationErrors": []
}

Puoi anche fornire una definizione JSON di Flow al momento della creazione e pubblicare immediatamente:

aws socialmessaging create-whatsapp-flow \
    --id {WABA_ID} \
    --flow-name "appointment_booking" \
    --categories '["APPOINTMENT_BOOKING"]' \
    --flow-json fileb://flow.json \
    --publish

Nota

Se lo includi--publish, il Flow JSON deve essere valido e superare la convalida di Meta. Se sono presenti errori di convalida, il Flow viene creato nello stato DRAFT e gli errori vengono restituiti nel campo. validationErrors

Per clonare un Flow esistente all'interno dello stesso WABA:

aws socialmessaging create-whatsapp-flow \
    --id {WABA_ID} \
    --flow-name "lead_form_v2" \
    --categories '["LEAD_GENERATION"]' \
    --clone-flow-id {FLOW_ID}

Aggiornamento di un flusso

Esistono due tipi di aggiornamenti che puoi apportare a un Flow:

• Aggiorna i metadati: modifica il nome o le categorie del flusso utilizzandoUpdateWhatsAppFlow.

• Aggiorna risorse: modifica la definizione JSON di Flow utilizzando. UpdateWhatsAppFlowAssets

Importante

L'aggiornamento delle risorse di un Flow pubblicato ne ripristina lo stato su DRAFT. È necessario ripubblicare il Flow affinché sia disponibile per l'uso nei messaggi.

L'esempio seguente aggiorna il nome di un Flow:

aws socialmessaging update-whatsapp-flow \
    --id {WABA_ID} \
    --flow-id {FLOW_ID} \
    --flow-name "updated_lead_form"

L'esempio seguente aggiorna la definizione JSON di Flow:

aws socialmessaging update-whatsapp-flow-assets \
    --id {WABA_ID} \
    --flow-id {FLOW_ID} \
    --flow-json fileb://updated_flow.json

Se Flow JSON contiene errori di convalida, questi vengono restituiti nella risposta. È necessario correggere questi errori prima di poter pubblicare il Flow.

Elencare e visualizzare i flussi

ListWhatsAppFlowsUtilizzalo per visualizzare tutti i flussi per un WABA e GetWhatsAppFlow per recuperare i dettagli su un flusso specifico.

Elenca tutti i flussi:

aws socialmessaging list-whatsapp-flows \
    --id {WABA_ID}

Ottieni dettagli per un flusso specifico:

aws socialmessaging get-whatsapp-flow \
    --id {WABA_ID} \
    --flow-id {FLOW_ID}

La GetWhatsAppFlow risposta include lo stato del flusso, le categorie, gli errori di convalida, la versione JSON, le informazioni di anteprima e lo stato di integrità.

Per recuperare la definizione JSON di Flow (risorse), usa: ListWhatsAppFlowAssets

aws socialmessaging list-whatsapp-flow-assets \
    --id {WABA_ID} \
    --flow-id {FLOW_ID}

La risposta include un URL di download predefinito per il file JSON di Flow. L'URL scade dopo un breve periodo. Non è necessaria alcuna autenticazione aggiuntiva per scaricare il file dall'URL.

Eliminazione di un flusso

È possibile eliminare solo i flussi che si trovano nello stato DRAFT. I flussi pubblicati o obsoleti non possono essere eliminati.

Per eliminare un flusso utilizzando la console, seleziona Flusso nella scheda Flussi e scegli Elimina.

Per eliminare un Flow utilizzando l'API:

aws socialmessaging delete-whatsapp-flow \
    --id {WABA_ID} \
    --flow-id {FLOW_ID}

avvertimento

L'eliminazione di un flusso è permanente e non può essere annullata.