# Chatbot User Authentication
#### Phone Number Authentication Setup
This guide walks you through integrating an API for phone number verification within your flow. You’ll set up two APIs—one to send the OTP and another to verify it. Follow these steps carefully.
**Step 1: Create the API for Sending OTP**
1. **Navigate to Developer Section**
Go to your platform's **Developer Section**.
2. **Add a New API**
Click on the **Add API** button as shown in the screenshot
* Enter an **API Name** (e.g., "Send OTP").
3. **Configure API Details**
* Choose the appropriate **Method** from the dropdown that is POST
* In the **API URL** field, enter the API endpoint provided for sending OTP.
{% hint style="info" %}
API :
{% endhint %}
1. **Set Headers**
* Go to the **Headers** section.
* Add the required authorization fields:
* **Authorization Key**: Enter the authorization key provided by the service.
* **Value**: Your token or key.
1. **Define Request Body Parameters**
* In the **Body** section, enter the parameters as shown in the screenshot:
* **accountSID**: Obtain from Twilio.
* **authToken**: Obtain from Twilio.
* **fromNumber**: Your Twilio phone number.
* **toNumber**: Map this to the user’s phone number attribute.
1. **Save API**
* Click **Save** to store the API configuration.
**Map Phone Number Attribute**
* In the **Attributes** section, select the user’s phone number attribute.
1. **Save Custom Attribute**
* In the **Manage API Response** section, choose **Save to Custom Attribute**.
* If not already created, create a custom attribute to store the verification status or OTP code.
***
**Step 2: Create the API for OTP Verification**
1. **Add Another API for OTP Verification**
* Click **Add API** again.
* Name this API (e.g., "Verify OTP").
1. **Set Method and URL**
* Choose the appropriate **Method** (POST).
* Enter the **API URL** for verifying OTP.
{% hint style="info" %}
API :
{% endhint %}
1. **Set Headers**
* Fill in the header details similar to Step 1.
1. **Define Request Body Parameters**
* In the **Body** section, pass:
* **systemOtp**: The OTP sent to the user.
* **userOtp**: The OTP entered by the user.
1. **Save API**
* Click **Save**.
***
**Step 3: Integrate APIs into the Chat Flow**
1. **Edit the Chat Flow**
* Go to **Edit Flow** and open the chat flow you want to edit.
1. **Add API Components**
* **Send OTP** API:
* Add the **API component** and select the API created in Step 1.
**Phone Number Input**:
* Add a component to capture the user’s phone number.
* **Verify OTP** API:
* Add the **API component** again and select the **Verify OTP** API from Step 2.
1. **Add Delays**
* Add a delay of 5 seconds between sending and verifying OTP, and 2 seconds if re-verifying.
1. **Response Messages**
* Configure messages to display whether the OTP was verified successfully or if the user should re-enter it.
***
This setup enables you to authenticate a user’s phone number seamlessly by sending and verifying an OTP.
---
# 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://help.botpenguin.com/platform-guidelines-and-trainings/unlock-power-of-botpenguin/chatbot-user-authentication.md?ask=
```
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.
