# Quickstart

Connecting your voiceflow project to FlowBridge is quick and easy. For this section you'll need 2 things:

* [ ] A project you created on [Voiceflow](https://voiceflow.com/) that you have "published" through the publish button on your flow
* [ ] A free account on [FlowBridge Connect](https://flowbridge.app/)

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!

{% stepper %}
{% step %}

### 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"

<figure><img src="/files/qArKfGgCLmyokWoNIiZ0" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### 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.

<figure><img src="/files/QYz8uuFZWDURICSrJGut" alt=""><figcaption></figcaption></figure>

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:

<figure><img src="/files/r3YFBl9zON6tMYw3zK06" alt=""><figcaption></figcaption></figure>

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&#x20;

<figure><img src="/files/oNSiYz9TG40DOQrvbGkp" alt=""><figcaption></figcaption></figure>

Now you can click `Create` and your voiceflow project is now available to associate to an integration&#x20;
{% endstep %}

{% step %}

### 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&#x20;

<figure><img src="/files/MV8jR875xjhbYm4hM0fB" alt=""><figcaption></figcaption></figure>

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}`

<figure><img src="/files/mppx13yYbJrRnA9ZWpEl" alt=""><figcaption></figcaption></figure>

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.&#x20;

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](https://developers.facebook.com/))&#x20;

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.&#x20;

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`

<figure><img src="/files/6pB2gBhqRWBtJPDk7HDh" alt=""><figcaption></figcaption></figure>

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.&#x20;

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.

<figure><img src="/files/mJoOdeL3wiKnI0yEIABt" alt=""><figcaption></figcaption></figure>

You can press the "Create" button (it might be disabled for a couple of seconds as FlowBridge Connect tries to connect to Meta)&#x20;
{% endstep %}

{% step %}

### Integration is live

Now you've fully completed the integration! Go ahead and try to send a message to your facebook page and it should trigger the voiceflow response!
{% endstep %}
{% endstepper %}

### 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 State` button


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.flowbridge.app/documentation/getting-started/quickstart.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.