Typeform

  
## Qué es
Una integración sencillamente genial para conectar tu cuenta Typeform con tu Botpress Bot. Envía formularios a los usuarios y recibe un evento con sus respuestas cuando se completen.

## Cómo funciona
La acción `Send Typeform Link` se puede utilizar para crear un nuevo enlace al formulario que desea utilizar. Requiere un Id de Conversación y una URL de Formulario. 

El `Conversation Id` es un identificador único para cada conversación. Puede pasar en este campo para incrustar su id. Cuando recibas un Evento puedes utilizar en las Opciones Avanzadas el campo `Conversation ID` del `Typeform Event Trigger`. Esto enviará el evento a la conversación apropiada.

URL del formulario" es la URL del formulario que deseas utilizar. Puedes encontrar el enlace en "Compartir" -> "Copiar enlace". Asegúrese de que ha configurado el campo oculto de la configuración de Typeform para pasar el id de conversación.

Puedes ver el código de integración completo en: https://github.com/SimplyGreatBots/typeform

## Configuración de Typeform
1. Vaya a su [Typeform Account](https://admin.typeform.com/user) y haga clic en `Personal Access Tokens`.
2. 2. Haga clic en "Generar nuevo token", asigne un nombre a su token y haga clic en "Generar token".
3. 3. Una vez creado el token, cópielo y guárdelo en un lugar seguro. Proceda a la configuración de Botpress y luego regrese para los pasos finales.
4. Crea/Abre el formulario que deseas integrar con tu bot y haz clic en `Conectar` en el menú superior.
5. Selecciona la opción Webhooks y haz clic en `Añadir un Webhook`.
6. Pega la URL de tu Botpress Typeform Webhook en el campo `Endpoint` y haz clic en `Save Webhook`.
7. Haga clic en editar en su nuevo Webhook y añada Typeform Access token al campo `Secret` y guarde los cambios.
8. 8. El último paso es configurar un campo oculto en su formulario con un identificador de conversación. Haz click en `Crear` en el formulario -> `Lógica` -> `Personalizar con datos` -> `Campos ocultos`.
9. Haz click en `Add new field` y ponle el nombre exacto: `conversation_id`
10. Guarde y ya está preparado para utilizar la integración de Botpress Typeform.

## Botpress Configuración
1. Haz clic en `Instalar` en la parte superior derecha y selecciona tu bot.
2. Haz clic en la ventana emergente que aparece para configurar tu integración.
3. Añade tu token de acceso de Typeform en el campo `Access Token`.
4. Habilite y guarde la integración.
5. Copie su URL Webhook para la integración. Se utilizará en el paso 6 de la configuración de Typeform.