Integrações

Listar Integrações

Retorna a lista simplificada de integrações ativas e configuradas da conta, contendo os IDs necessários para envio de mensagens.

GET/integration
curl --request GET \
  --url 'https://crm.wavups.com/api/v1/integration' \
  --header 'Token: SEU_TOKEN_DE_API'
[
  {
    "id": "cmint1234567890",
    "platformName": "WhatsApp Business",
    "integrationAccountName": "+55 11 99999-0000",
    "status": "active",
    "createdAt": "2026-01-10T12:00:00.000Z"
  },
  {
    "id": "cmint9876543210",
    "platformName": "Instagram",
    "integrationAccountName": "@minhaempresa",
    "status": "active",
    "createdAt": "2026-01-15T15:30:00.000Z"
  }
]

Visão Geral

Utilize este endpoint para consultar todas as integrações de canais (como WhatsApp Business, Instagram e Z-API) associadas à sua conta.

O campo id retornado para cada integração é o accountIntegrationId que deve ser informado nas rotas de envio de mensagens no WhatsApp e Instagram.


Requisição

GET https://crm.wavups.com/api/v1/integration

Tokenstringobrigatório

Seu token de autenticação.


Resposta

Retorna um array com as integrações da conta.

idstring

Identificador único da integração no banco de dados. Utilize este valor como accountIntegrationId nas requisições de envio de mensagens e criação de conversas.

Nome legível da plataforma (ex: WhatsApp Business, Instagram, Z-API).

Nome de identificação da conta integrada (ex: número de telefone ou nome da página/perfil).

statusstring

Status atual da integração (ex: active).

createdAtstring

Data e hora de criação da integração (ISO 8601).


Autorização

Tokenstring · headerobrigatório

Token de autenticacao gerado na plataforma WavUps CRM.

Respostas

200application/json · object[]

Lista de integrações retornada com sucesso.

idstring

ID único da integração.

Nome da plataforma.

Nome da conta integrada.

statusstring

Status da integração.

createdAtstring<date-time>
500