Typeform

  
## Cos'è
Un'integrazione semplicemente fantastica per collegare il vostro account Typeform al vostro bot Botpress . Inviate moduli agli utenti e ricevete un evento con le loro risposte quando vengono completati.

## Come funziona
L'azione `Invia link Typeform` può essere usata per creare un nuovo link al modulo che si desidera utilizzare. Richiede l'ID della conversazione e l'URL del modulo. 

L'"Id conversazione" è un identificatore unico per ogni conversazione. Si può passare in questo campo per incorporare il proprio id. Quando si riceve un evento, è possibile utilizzare nelle opzioni avanzate il campo `Conversation ID` del `Typeform Event Trigger`. In questo modo l'evento verrà inviato alla conversazione appropriata.

URL del modulo" è l'URL del modulo che si desidera utilizzare. Il link si trova in `Condividi` -> `Copia link`. Assicurarsi di aver impostato il campo nascosto dalla configurazione di Typeform per passare l'id della conversazione.

È possibile vedere il codice di integrazione completo all'indirizzo: https://github.com/SimplyGreatBots/typeform

## Impostazione di Typeform
1. Andare al proprio [Account Typeform] (https://admin.typeform.com/user) e cliccare su `Gettoni di accesso personali`.
2. Cliccare su `Generare un nuovo token`, assegnare un nome al token e cliccare su `Generare un token`.
3. Una volta creato il token, copiarlo e salvarlo in un luogo sicuro. Procedere con la configurazione di Botpress e poi ritornare per le fasi finali.
4. Creare/aprire il modulo che si desidera integrare con il bot e fare clic su `Connect` nel menu in alto.
5. Selezionare l'opzione Webhooks e fare clic su `Aggiungi un Webhook`.
6. Incollare l'URL di Botpress Typeform Webhook nel campo `Endpoint` e fare clic su `Save Webhook`.
7. Fare clic su modifica del nuovo Webhook e aggiungere il token di accesso di Typeform al campo `Secret` e salvare le modifiche.
8. Il passo finale consiste nell'impostare un campo nascosto nel modulo con un id di conversazione. Fare clic su `Crea` nel modulo -> `Logica` -> `Personalizza con i dati` -> `Campi nascosti`.
9. Fare clic su `Aggiungi un nuovo campo` e assegnargli un nome esatto: `conversation_id`.
10. Salvare e ora si è pronti a utilizzare l'integrazione di Botpress Typeform.

## Botpress Configurazione
1. Fare clic su `Install` in alto a destra e selezionare il bot.
2. Fare clic sul popup visualizzato per configurare l'integrazione.
3. Aggiungere il proprio token di accesso a Typeform nel campo "Token di accesso".
4. Attivare e salvare l'integrazione.
5. Copiare l'URL Webhook per l'integrazione. Questo verrà utilizzato nel passaggio 6 della configurazione di Typeform.