Persat

Add a bot to Persat using the official integration.

Open in Hubv

The official Persat integration allows your bot to interact with your Persat clients.

Setup

You will need:

• A published bot
• A Persat account

1. Install the integration in Botpress

   First, install the integration to your bot:

   1. In Botpress Studio, select Explore Hub in the upper-right corner.
   2. Search for the Persat integration, then select Install Integration.

   In the Configuration menu, you should see one field: API Key

   Leave this empty for now—you’ll come back to it after creating your Persat API key.

2. Create a Persat API key

   Next, create a Persat API key:

   1. Log in to your Persat account.
   2. Select your avatar in the upper-right corner, then select Integraciones y Partners.
   3. Select Integra con nuestra API, then go to API keys.
   4. Create and copy a new API key. When prompted to configure its access level, make sure you select Acceso Total (complete access).
3. Configure the integration in Botpress

   Now, you can finish setting up the integration in Botpress:

   1. In the integration’s API key field, paste your Persat API key.
   2. Select Save Configuration.

Your Persat integration is ready. You can use its Cards to interact with your Persat clients.

---

Cards

Here’s a reference for all Cards available with the integration:

Create Client

input · object

Show child attributes

company_name · string · required

output · object

Show child attributes

success · boolean · required

data · object · required

Show child attributes

custom_fields · object

Get Client

input · object

Show child attributes

uid_client · string · required

output · object

Show child attributes

success · boolean · required

data · object · required

Show child attributes

custom_fields · object

Submit Form

input · object

Show child attributes

uid_client · string · required

df_data · object · required

Show child attributes

schema_id · number · required

output · object

Show child attributes

success · boolean · required

data · object · required

Show child attributes

_id · string · required

created · string · required

created_by_user_name · string · required

created_by_user_id · number · required

client · object · required

Show child attributes

id · number · required

name · string · required

uid_client · string · required

df_data · object · required

Show child attributes

schema_id · number · required

results · object · required

Show child attributes

last_updated · string · required

state · object · required

Show child attributes

color · string · required

deleted · boolean · required

id · number · required

name · string · required

Update Client

output · object

Show child attributes

success · boolean · required

data · object · required

Show child attributes

custom_fields · object