

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Creazione e modifica WhatsApp dei flussi
<a name="managing-flows-create"></a>

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)
<a name="managing-flows-create-console"></a>

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

1. Scegli un **account aziendale**, quindi scegli un WABA.

1. Scegli la scheda **Flussi**.

1. Scegliere **Create flow (Crea flusso)**.

1. 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).

1. 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

1. 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

1. 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)
<a name="managing-flows-create-api"></a>

Usa l'`CreateWhatsAppFlow`API 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
<a name="managing-flows-update"></a>

Esistono due tipi di aggiornamenti che puoi apportare a un Flow:
+ **Aggiorna i metadati**: modifica il nome o le categorie del flusso utilizzando`UpdateWhatsAppFlow`.
+ **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
<a name="managing-flows-list"></a>

`ListWhatsAppFlows`Utilizzalo 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
<a name="managing-flows-delete"></a>

È 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.