> ## Documentation Index
> Fetch the complete documentation index at: https://docs.convocore.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> Guide to integrating Voiceflow with Convocore, including analytics, templates, and library components.

## Introduction

This documentation covers the integration of Voiceflow with [Convocore](https://convocore.ai/). Learn how to connect your Voiceflow projects, access analytics, and leverage templates and library components for better performance.

### Prerequisites

* [Voiceflow](https://www.voiceflow.com/) account and access to your project dashboard.
* A Voiceflow **project API key** (`VF.DM...`) or a **personal access token** (`vfp_...`).
* The Voiceflow **Project ID**. Required when you use a personal access token.
* Access to the [Convocore](https://convocore.ai/) platform.

***

## Connecting the Voiceflow Agent

### Step 1: Gather Required Information

* Log in to your [Voiceflow](https://www.voiceflow.com/) account.
* Copy a **project API key** (`VF.DM...`) from the project, or a **personal access token** (`vfp_...`) from Settings → Access tokens.
* Copy the **Project ID** from Settings → General → Metadata. See
  [Authentication](/integration/Voiceflow/authentication) for Project ID vs
  Version ID and how to create a `vfp_...` token.

<img src="https://mintcdn.com/convocore-app/WxIYpecoz6qeT0hc/images/voiceflow/new1.gif?s=6506b27c841735c74341c3ebe60a304f" alt="Voiceflow AgentID and ProjectID" width="800" height="450" data-path="images/voiceflow/new1.gif" />

### Step 2: Configure in Convocore

1. Open the agent in [Convocore](https://convocore.ai/) and go to **Settings → Integrations**.
2. Turn on **Voiceflow Integration**.
3. Paste the `VF.DM...` key or `vfp_...` token, plus the **Project ID**.
4. Set the environment alias (`production`, `development`, or `main`) and save.

<img src="https://mintcdn.com/convocore-app/WxIYpecoz6qeT0hc/images/voiceflow/new2.gif?s=0e5b83e2bdbb280abbe43add1fbb6a46" alt="Convocore Integration" width="800" height="450" data-path="images/voiceflow/new2.gif" />

<Note>
  Personal access tokens need a Project ID. New Voiceflow projects usually use the
  `main` environment alias. Older canvas projects use `production` or `development`.
</Note>

***

## Voiceflow Analytics

### Accessing Analytics

* Go to your Convocore agent dashboard.
* Navigate to the **Analytics** section.

<Warning>
  To access the analytics, ensure that your Voiceflow credential (`VF.DM...` or
  `vfp_...`) and **Project ID** are correctly configured in the platform.
</Warning>

### Key Metrics Explained

* **Total Interactions:** Total number of interactions your users have had with the agent.
* **Total Conversations:** Number of total conversations your AI agent has had across all platforms.
* **User Retention:** Total messages exchanged before the user leaves the conversation.
* **Top Intents:** Most triggered intents on your agent, showing the most common actions users take.
* **Time Retention:** Seconds users have spent interacting with the agent.

<img src="https://mintcdn.com/convocore-app/WxIYpecoz6qeT0hc/images/voiceflow/3.gif?s=b28edec5749dc04b27a8391e047a52e8" alt="Analytics" width="1899" height="904" data-path="images/voiceflow/3.gif" />

<Tip>
  ### Using Insights Effectively Use these insights to optimize your agent's flows and

  enhance user satisfaction.
</Tip>

***

## Voiceflow Template

<img src="https://mintcdn.com/convocore-app/WxIYpecoz6qeT0hc/images/voiceflow/5.gif?s=1a1a7a3a3ae16b889044502eb70c7f3d" alt="Voiceflow Template" width="1899" height="904" data-path="images/voiceflow/5.gif" />

### Where to Find the Template

* Locate the Voiceflow template in the **[Convocore](https://convocore.ai/)** profile section or download it directly from [here](https://cdn.voiceglow.org/public/VGLatestTemplate.vf).

### Importing the Template

1. Download the Voiceflow template file.
2. Go to your Voiceflow [creator page](https://creator.voiceflow.com/).
3. Import the template using the **Import** option.

<img src="https://mintcdn.com/convocore-app/WxIYpecoz6qeT0hc/images/voiceflow/new4.gif?s=b4d27d526db118537ea758ca8b0533c2" alt="Voiceflow Template upload" width="800" height="450" data-path="images/voiceflow/new4.gif" />

<Warning>
  It's crucial to use the **latest** Voiceflow Template to ensure smooth functionality and
  avoid any potential issues with the agent!
</Warning>

***

## Using Library Components

### Overview

Library components in the Voiceflow template are pre-built, reusable tools designed to simplify and enhance your conversational flow creation. They help you save time, ensure consistency, and provide advanced functionality without starting from scratch.

***

### Step-by-Step Guide

<img src="https://mintcdn.com/convocore-app/WxIYpecoz6qeT0hc/images/voiceflow/6.gif?s=3a4d640bb068cbfc77fb7b0b36714dde" alt="Using Library Components" width="1899" height="904" data-path="images/voiceflow/6.gif" />

#### 1. **Locate Components in the Voiceflow Template**

* Open the Voiceflow template in your Voiceflow creator.
* Navigate to the **Library** section to view the available components.

#### 2. **Drag and Drop**

* Select the desired component and drag it into your conversation flow.

<Note>
  If you're not importing the whole template into your flow and just a single component,
  make sure to create the variables and intents needed for that component so nothing
  breaks.
</Note>

#### 3. **Customize**

* Modify the component’s settings to suit your agent’s requirements, such as adding specific intents, API endpoints, or fallback messages.

#### 4. **Test Your Flow**

* Use Voiceflow's testing environment to simulate interactions and ensure the components work as expected.

***

### Video Tutorial

Watch a detailed guide to using library components:

<iframe width="560" height="315" src="https://www.youtube.com/embed/M89K1M1d2bA" title="Convocore Example 2" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; fullscreen" allowfullscreen />

<Tip>
  ### Pro Tip: Start with basic components, then progressively integrate more advanced

  ones as you refine your agent's capabilities.
</Tip>

***

## Extensions Page

### What Are Extensions?

Extensions enhance the functionality of your Voiceflow agents by adding new capabilities or integrations.

[Visit Extensions Page](/integration/Voiceflow/extensions)