Learn how to integrate Poli with other tools and automate your processes using our API. Here you will find the main endpoints, request examples, and usage instructions.

Authentication (API Token)

To integrate Poli with other platforms, you will need an API Token. This code acts as your company’s unique access key to authenticate requests.

Step-by-step to generate your token:

• Go to the Home Page of your dashboard.
• In the navigation menu, click on Settings.
• Access the Integrations section and select the API tab.
• Click on Create new token.
• Define a name to identify your token.
• The system will generate the access code. Copy the generated token to use it in your HTTP request headers.

Treat this token with the same level of care as a password. It provides direct access to your company's data. Never expose it in public repositories or share it with unauthorized individuals.

How to use the token

Send the token in the request header:

Authorization: Bearer YOUR_TOKEN_HERE

Chats

List chats

GET:
https://app.poli.digital/api/v1/customers/{{customer}}/chats

Returns all chats from the account.

List messages from a chat

GET:
https://app.polichat.com.br/api/v1/customers/{{customer}}/chats/contacts/{{contact}}/messages

Returns all messages from a specific contact.

Contacts

List contacts

GET:
https://app.poli.digital/api/v1/customers/{{customer}}/contacts

Update contact

PUT:
https://app.poli.digital/api/v1/customers/{{customer}}/contacts/{{contact}}

Body:

{
  "id": "",
  "phone": "",
  "email": "",
  "name": "",
  "user_id": "",
  "cpf": "",
  "address": "",
  "gender": ""
}

Channels

List channels

GET:
https://app.poli.digital/api/v1/customers/{{customer}}/channels

Update channel

PUT:
https://app.poli.digital/api/v1/customers/{{customer}}/channels/{{channel}}

Body:

{
  "channel": "",
  "name": "",
  "url": "",
  "phone": ""
}

Delete channel

DELETE:
https://app.poli.digital/api/v1/customers/{{customer}}/channels/{{channel}}

Messages

Send message (WhatsApp)

POST:
https://app.poli.digital/api/v1/customers/{{customer}}/whatsapp/send_text/channels/{{channel}}/contacts/{{contact}}/users/{{user}}

Body:

{
  "usermsg": "Message here",
  "database64": "",
  "mimetype": "",
  "caption": "",
  "name": ""
}

Send template

POST:
https://app.poli.digital/api/v1/customers/{{customer}}/whatsapp/send_template/channels/{{channel}}/contacts/{{contact}}/users/{{user}}

Body:

{
  "quick_message_id": "",
  "tag": "",
  "parameters": []
}

Tags

List tags

GET:
https://app.poli.digital/api/v1/tags/{{customer}}

Create tag

POST:
https://app.poli.digital/api/v1/tags/{{customer}}

Body:

{
  "name": "",
  "color": ""
}

Add tag to a contact

POST:
https://app.poli.digital/api/v1/tags/{{customer}}/{{tag}}/addContact/{{contact}}

Delete tag

DELETE:
https://app.poli.digital/api/v1/tags/{{customer}}/{{tag}}