Quickstart
Connecting your voiceflow project to FlowBridge is quick and easy. For this section you'll need 2 things:
Once you have these 2 things, we're ready to get you integrated with one of the integrations! For this example, we'll use Facebook Messenger as our integration. You can go to the Integrations documentation to get more information on the specific integration you need!
Lets integrate with Facebook!
Once you've created a FlowBridge Connect account, you should be redirected to your personal environment. The URL will be a sub-domain of FlowBridge chosen by you (i.e https://{your-sub-domain}.flowbridge.app)
This is the domain to your personal environment, where you login and manage your integrations. This is also the link you share with your clients to be able to login and view the analytics and chats.
There a Customer panel as well as a Admin panel. The customer panel is where you can view chat messages, initiate human handoff, reset user states and more.
The Admin Panel is where you will manage your client companies, voiceflow projects and integrations.
Let's make the first integration!
Create a client company
Within the Admin Panel of your FlowBridge connect environment, you will see a navigation option Client Companies . Voiceflow Projects are associated with Client Companies. When you create a normal (non-admin) user, you can associate it with a client company too. Once they login to your environment, they will only be able to see Voiceflow projects associated with the company they are associated to.
Lets call the Client Company "My Company"

Create a Voiceflow Project
The next step is to create a Voiceflow project within your FlowBridge Connect environment. This serves as the "Bridge" between FlowBridge Connect and Voiceflow. We first associate the Voiceflow Project with a Client Company. This means users associated with that company will be able to see this project.

To find the Project ID for your voiceflow project, once you open the specific project on Voiceflow, you can hit the cogwheel icon, click "general" and your Project ID will be found there:

To find the API key, in the same settings screen, you will see an option API Keys in the navigation. You will be able to copy the API token there, and paste it in to the "Voiceflow API Token" field

Now you can click Create and your voiceflow project is now available to associate to an integration
Create the Facebook Integration
Our next step is to create an integration and associate it with the Voiceflow project. You can integrate multiple different integrations to the same project such as Instagram and Facebook. For this example, we'll demonstrate the Facebook integration.
Go to the Client Integrations page in the navigation on the admin panel of your FlowBridge Connect environment and create a new integration
First, we'll want to associate both a Company and Voiceflow Project for the integration. We'll select the 2 we just made
Next we'll be prompted to give the integration a name. Let's give it a logical name so we know which integration this is like {Project Name} {Integration Name}

Now we want to select which integration channel we want to connect with. In our case it will be Facebook. Once you select the channel, different options may appear based on which integration channel you're trying to integrate with.
In the case of Facebook, we have the option to use the Meta API provider, or a custom provider. Custom providers allow you to create your own Developer App on the meta platform (https://developers.facebook.com)
We don't provide support on custom integrations, though the option is provided to you for advanced use cases but requires you to also go through Meta App review.
Let's stick with Meta API. After clicking the "Login with Facebook" button, a popup should appear (make sure your browser has popups enabled). This is a page provided by Meta. Follow the prompts on the screen until you reach the last page with the button Got it

Once you press Got it the integration page should appear again and after a couple of moments, it should show the Access token provided by Meta.
You now can select which facebook page this integration i for based on which pages you have allowed us to manage through the popup screen.

You can press the "Create" button (it might be disabled for a couple of seconds as FlowBridge Connect tries to connect to Meta)
Some considerations
Your Voiceflow Project should ALWAYS start with a capture utterance step. This is because users will be initiating the conversation to Voiceflow. If you do not start with a capture step, it Voiceflow will skip over the first messages until the next capture step.
You can connect multipe integrations to the same project.
When using Voiceflow and FlowBridge, there are some extra considerations to keep in mind when building out your flow. Voiceflow was built around the use of Webchat where user sessions generally end upon the page closing. Given instant messaging platforms such as WhatsApp and Messenger don't actually "close", the state never ends. This can cause issues when updating the flow. Users with an existing session may need their user state reset, setting them back to the beginning of the flow, to receive the latest version. This can be done on the Client Panel > Chat Messages > Click on the chat > Click the
Reset User Statebutton
Last updated
