Connectors: API Tokens and Webhooks

From the Connectors page, you connect your systems and apps to Flovoo, using API tokens to send requests and webhooks to receive events on your server.

The article is for your technical team or whoever builds the integration, and explains how to create and manage tokens and add webhooks.

Create an API token

To create an API token:

1. 1
   Click Connectors in the sidebar, then API.
2. 2
   Click Create API Token.
3. 3
   Enter a Name, such as Website integration.
4. 4
   Under Scopes, select only what the integration needs, or click Select all.
5. 5
   Confirm to create the token, then click Copy token.

Token scopes

Scopes define what the token can access. Each group has a view scope and a manage scope:

• Contacts, Conversations, Tags, and Stages.
• Segments, Quick replies, and Custom fields.
• Broadcasts, WhatsApp templates, and Team members.
• Webhooks to create webhooks through the API.

Manage API tokens

Your tokens appear in the Your tokens table with the Name, Access, and Last used. From the Actions column, you can:

• Regenerate: replaces the token’s secret with a new one, and you can update its name and scopes. The current token stops working right away.
• Delete: any app using the token loses access, and you can’t undo the deletion.

API documentation

Open the API Docs tab to see all available requests, such as contacts, conversations, and messages. From there, you can try requests with your token or download the Postman collection.

Add a webhook

A webhook notifies your server the moment an event happens, such as a new message, a contact update, or a template status change. To add a webhook:

1. 1
   Click Connectors, then Webhooks.
2. 2
   Click Add webhook.
3. 3
   Enter the Endpoint URL and select the Events you want to receive.
4. 4
   Copy the Signing secret and store it on your server.

We sign every delivery with the signing secret so you can verify the request came from Flovoo. You need to connect at least one WhatsApp channel before adding a webhook. To learn how to connect channels, see Manage Channels.

To learn about the other sections of Flovoo, see A Quick Tour of Flovoo.