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

# Voice API Integration

> How the flow works

<Info>
  **Prerequisite**: Please create an account on [Protegee](https://protegee.ai/) and visit the [settings](https://protegee.ai/settings) page to grab your `api_token` and `transfer` number.
</Info>

The section you want will look something like:

<img className="block" src="https://mintcdn.com/protegee/hyzol41G7875b8OT/images/settings-token-and-transfer.png?fit=max&auto=format&n=hyzol41G7875b8OT&q=85&s=d702cde58644474c198febf08b608125" alt="Example API token and Transfer number" width="446" height="345" data-path="images/settings-token-and-transfer.png" />

Once you have the `api_token` and the `transfer_number`, follow these instructions to get up and running:

### Control flow

<img className="block" src="https://mintcdn.com/protegee/hyzol41G7875b8OT/images/caller-flow.png?fit=max&auto=format&n=hyzol41G7875b8OT&q=85&s=7efe32c6197abcfb9291900739cf40a5" alt="Example API token and Transfer number" width="4624" height="1328" data-path="images/caller-flow.png" />

**Step 1**: Webhook set-context:

Before you can transfer the call to [Protegee](https://protegee.ai/), you need to tell it some details about the call (who the caller is, price, what are they trying to buy, etc).

An example of what this API looks like for Twilio is: [Set Context](/docs/api-reference/endpoint/set-context_twilio)

**Step 2**: Transfer to Protegee:
Exactly like it sounds, have your agent transfer the call to you.

**Step 3**: Transfer Back (optional):
There is nothing you need to do in this step. [Protegee](https://protegee.ai/) will transfer the caller back to whatever you specify in the `callback` field in the API. If it is left empty, the call is ended once payment is complete.

**Step 4**: Webhook get-context (optional)

Hitting the `get-context` endpoint will share details about how the payment processor went. To see an example of what this looks like for Twilio, check out: [Get Context](/docs/api-reference/endpoint/get-context_twilio)