Typeform

Nautical integrates with Typeform for onboarding sellers or customers through a sign-up form.

Before you start

• You must have an active Typeform account. Create one if you don't have one already.
• Create the Typeform workspace that you want to connect to Nautical.
• You must generate a personal token to grant Nautical access to Typeform. Save this token as you'll need to enter it while activating the Typeform integration. For instructions, see the Typeform documentation.
  note

  When generating the token set Scopes to All scopes

  

Activate the Typeform app in Nautical

1. From the Dashboard, go to Settings -> Apps.
2. Open Typeform
3. Under Authorization, enter the personal token you generated from Typeform.
4. Select Activate to enable the integration.

Set up form data mappings

After activating the Typeform integration, you must set up data mappings to ensure that the system can correctly map the fields received from your forms.

Create a mapping for each Typeform form you want to receive data from. You can set up data mappings to create sellers or customers, determined by the process you select in the data mapping.

Steps

1. Go to Settings -> Apps -> Typeform.
2. Under Data Mappings, select Add new mapping.
   The Add Flow Mapping dialog appears.
3. Select the Process you want to map incoming data for:
   • CUSTOMER_CREATION: Map the incoming data to create customer accounts.
   • SELLER_CREATION: Map the incoming data to create seller accounts.
4. In the Form field, select the name of the form you are creating the mapping for.
5. In the fields that appear, select where to map each field received from Typeform.
   note

   Required fields are marked with an asterisk.

6. Select Save.

Configure webhooks

You must configure Typeform to send webhook payloads to Nautical, and then start the Nautical webhook listener to process the incoming webhooks.

Configure webhooks in Typeform

1. Log in to your Typeform account.
2. Open an existing Typeform workspace.
   note

   Ensure the project is Published.

3. From the navigation bar in your project workspace, select Connect.
4. Open the Webhooks tab.
5. Select Add a webhook.
6. In the Endpoint field, enter your marketplace webhook endpoint, and then select Save.
   note

   The endpoint to receive webhooks is in the following format: https://api-<domain_name>.com/webhooks/

7. To activate the webhook, select Webhook ON.
8. Select View deliveries to see the webhook traffic.
9. Select Send test request to verify the payload is being received by Nautical

Start the Nautical webhook listener

You must enable the webhook listener for Nautical to process incoming webhooks.

1. From your Nautical dashboard, go to Settings -> Webhooks.
2. On the Webhook Jobs page, select Enable Schedule.

tip

You only need to enable the schedule once for each app that send webhooks.