Schriftform

  
## Was es ist
Eine einfach großartige Integration, um Ihr Typeform-Konto mit Ihrem Botpress Bot zu verbinden. Senden Sie Formulare an Benutzer und erhalten Sie ein Ereignis mit ihren Antworten, wenn sie abgeschlossen sind.

## Wie es funktioniert
Die Aktion "Typeform Link senden" kann verwendet werden, um einen neuen Link zu dem Formular zu erstellen, das Sie verwenden möchten. Sie erfordert eine Konversations-ID und eine Formular-URL. 

Die "Conversation Id" ist ein eindeutiger Bezeichner für jede Konversation. Sie können in dieses Feld Ihre Id einbetten. Wenn Sie ein Ereignis empfangen, können Sie in den erweiterten Optionen das Feld "Conversation ID" des "Typeform Event Trigger" verwenden. Dadurch wird das Ereignis an die entsprechende Konversation weitergeleitet.

Form URL" ist die URL des Formulars, das Sie verwenden möchten. Sie finden den Link unter `Share` -> `Copy Link`. Vergewissern Sie sich, dass Sie das verborgene Feld aus dem Typeform-Setup so eingerichtet haben, dass die Konversations-ID übergeben wird.

Den vollständigen Integrationscode finden Sie unter: https://github.com/SimplyGreatBots/typeform

## Typeform-Einrichtung
1. Gehen Sie zu Ihrem [Typeform-Konto] (https://admin.typeform.com/user) und klicken Sie auf `Personal Access Tokens`.
2. Klicken Sie auf `Neues Token generieren`, benennen Sie Ihr Token und klicken Sie auf `Token generieren`.
3. Nachdem das Token erstellt wurde, kopieren Sie es und speichern es an einem sicheren Ort. Fahren Sie mit der Einrichtung von Botpress fort und kehren Sie dann für die letzten Schritte zurück.
4. Erstellen/öffnen Sie das Formular, das Sie mit Ihrem Bot integrieren möchten, und klicken Sie im oberen Menü auf "Verbinden".
5. Wählen Sie die Option "Webhooks" aus und klicken Sie auf "Add a Webhook".
6. Fügen Sie Ihre Botpress Typeform Webhook URL in das Feld `Endpoint` ein und klicken Sie auf `Speichern Webhook`.
7. Klicken Sie auf "Bearbeiten" auf Ihrer neuen Webhook und fügen Sie Typeform Access Token in das Feld "Secret" ein und speichern Sie die Änderungen.
8. Der letzte Schritt ist die Einrichtung eines versteckten Feldes in Ihrem Formular mit einer Konversations-ID. Klicken Sie im Formular auf "Erstellen" -> "Logik" -> "Personalisierung mit Daten" -> "Versteckte Felder".
9. Klicken Sie auf "Neues Feld hinzufügen" und benennen Sie es genau: `Gesprächs-ID`
10. Speichern Sie und Sie sind nun bereit, die Botpress Typeform-Integration zu verwenden.

## Botpress Einrichtung
1. Klicken Sie oben rechts auf `Installieren` und wählen Sie Ihren Bot aus.
2. Klicken Sie auf das Popup, das erscheint, um Ihre Integration zu konfigurieren.
3. Fügen Sie Ihr Typeform-Zugangstoken in das Feld "Zugangstoken" ein.
4. Aktivieren und speichern Sie die Integration.
5. Kopieren Sie Ihre Webhook URL für die Integration. Diese wird in Schritt 6. der Typeform-Einrichtung verwendet.