Aprende a integrar Poli con otras herramientas y automatizar tus procesos utilizando nuestra API. Aquí encontrarás los principales endpoints, ejemplos de solicitudes e instrucciones de uso.

Autenticación (Token de API)

Para realizar integraciones de Poli con otras plataformas, necesitarás un Token de API. Este código funciona como la clave de acceso única de tu empresa para autenticar las solicitudes.

Paso a paso para generar tu token:

• Accede a la Página Principal de tu panel.
• En el menú de navegación, haz clic en Configuración.
• Accede a la sección de Integraciones y selecciona la pestaña API.
• Haz clic en Crear nuevo token.
• Define un nombre de identificación para tu token.
• El sistema generará el código de acceso. Copia el token generado para utilizarlo en el encabezado de tus solicitudes HTTP.

Aviso de Seguridad:

Trata este token con el mismo cuidado que una contraseña. Otorga acceso directo a los datos de tu empresa. Nunca lo expongas en repositorios públicos ni lo compartas con personas no autorizadas.

Cómo usar el token

Envía el token en el encabezado de la solicitud:

Authorization: Bearer TU_TOKEN_AQUI

Chats

Listar chats

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

Devuelve todos los chats de la cuenta.

Listar mensajes de un chat

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

Devuelve todos los mensajes de un contacto específico.

Contacts

Listar contactos

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

Actualizar contacto

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

Body:

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

Channels

Listar canales

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

Actualizar canal

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

Body:

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

Eliminar canal

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

Messages

Enviar mensaje (WhatsApp)

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

Body:

{
  "usermsg": "Mensaje aquí",
  "database64": "",
  "mimetype": "",
  "caption": "",
  "name": ""
}

Enviar 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

Listar tags

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

Crear tag

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

Body:

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

Agregar tag a un contacto

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

Eliminar tag

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