# Developers

{% embed url="<https://youtu.be/tX6LNIlc8lg?feature=shared>" %}

Empower your developers to harness the full potential of your dashboard. In this section you can configure your APIs. You can test and manage the same which you can use to trigger in your chat flows.

## Hands on Developers Section

Step 1: Go to Home page of BotPenguin.

Step 2: Click on "Developers" section available under more options.&#x20;

<figure><img src="/files/7b9P8GvF29Moo3xS4GpC" alt=""><figcaption><p>API Management</p></figcaption></figure>

Step 3: Inside "Your APIs" you can see all the APIs previously created by you and can edit or delete the same. You can also search an API using API name.

Step 4: Click on "Add API" to create and add a new API according to your use case.

Step 5: Inside "Configure API" you can add:

* API Name
* Methods for API request (Get, Post, Put or Delete)
* API URL

<figure><img src="/files/mfpGrvGeQs9OxmcSM167" alt=""><figcaption><p>Configure API</p></figcaption></figure>

{% hint style="success" %}
The steps to be followed from "Step 6" are completely optional.
{% endhint %}

Step 6: Enter information in the navigation tabs

* Parameters -> Enter a key and its value, you can also add more fields for the same. It is used to append variables in the URL. You can map attribute values here.

<figure><img src="/files/cZUJMRMAZ88PvjjBed32" alt=""><figcaption><p>Parameters</p></figcaption></figure>

* Headers -> They contain sensitive information about the request and the response. Here also you can map the custom attributes

<figure><img src="/files/2RZNExDfuj0K6gTytyAF" alt=""><figcaption><p>headers</p></figcaption></figure>

* &#x20;Body -> Used to send the data with the request. You can also select a custom attribute by using "/" to send in the body. And also you can send a static message by typing it in between " ".

{% hint style="warning" %}
Recommended not to be sent with GET request.
{% endhint %}

<figure><img src="/files/L9DNksEibKDmfSlIVjod" alt=""><figcaption><p>Body</p></figcaption></figure>

* Manage API Response -> When API is hit the response received will be mapped with a custom attribute that can be selected from the drop down. Select a custom attribute for the variable.

<figure><img src="/files/nZqpSIO2z4SAbWlfuTRH" alt=""><figcaption><p>Manage API Responses</p></figcaption></figure>

* Third Party Integrations -> You can click on "Connect" to integrate with third party apps. This will redirect you to their page for further process.

<figure><img src="/files/1xeIOysiLEpLroUnkb4G" alt=""><figcaption><p>3rd Party Integration</p></figcaption></figure>

Step 7: After that click on "Test" to test your API Configurations.

Step 8: And click on "Save".

Step 9: In API Logs you will get detailed record of all API requests & responses triggered within the chatflow of the chatbot.

Step 10: In Access Token you can generate your token for using platform's API's which can be sent in API headers inside Auth key.&#x20;

Step 11: Click on "Regenerate API Token" to have your Access Token regenerated.

<figure><img src="/files/jpssGvM7raNtlRc80adC" alt=""><figcaption><p>Access Token</p></figcaption></figure>

### Using API in Chat-flow

* Now go to the bot section and select the bot in which you want to setup your API.&#x20;
* Select the flow in which you want to use your API
* Add "API" component into your chat flow.&#x20;
* Select the API component and customize it.
* You can map a go to next message for:\
  1\. others -> This includes scenarios in which neither success nor fail. Ex: Server Down. \
  2\. 200 -> It is response code which means your API is working good and its a success.\
  3\. 400 -> It is response code which means your API is not working and its a fail case.

<figure><img src="/files/L8BJOpOegumQM5MvKyJV" alt=""><figcaption><p>flow</p></figcaption></figure>

* You can use your custom attribute which was mapped with the API by typing "/".

Here when response code 200 is recieved. The next message will be sent as "Today's Fact is {{cat\_fact}} ". This will contain the data that will be received from the API source.

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

#### Need Help?

Please feel free to reach out to us at <mark style="color:$primary;"><support@botpenguin.com></mark>, in case of any questions or concerns.


---

# 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://partners.botpenguin.com/customer-platform-guidelines/developers.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.