Ler conversas e dados da conta
As rotas /v1 leem tudo que o painel mostra — com os mesmos nomes do painel e as mesmas permissões do usuário do token. São somente leitura: nada em /v1 altera a conta.
| Recurso | Rotas |
|---|---|
| Conta | GET /v1/me |
| Tíquetes (conversas) | /v1/tickets · /{id} · /{id}/messages |
| Mensagens | /v1/messages · /{id} |
| Contatos | /v1/contacts · /{id} · /{id}/tickets |
| Propriedades | /v1/properties · /{id} |
| Tags · Notas · Status de tíquete | /v1/tags · /v1/notes · /v1/ticket-status |
| Listas | /v1/lists · /{id} · /{id}/contacts |
| Campanhas e automações | /v1/campaigns · /v1/automations |
| Canais e templates | /v1/channels · /v1/templates |
| Usuários | /v1/users |
| IA | /v1/assistants · /v1/knowledge-bases |
Exemplos
Tíquetes abertos de um canal, mais recentes primeiro
curl 'https://api.picchat.com.br/v1/tickets?open=true&channel_id=ID_DO_CANAL&sort=last_message_date&order=desc' \
--header 'Authorization: Bearer SEU_TOKEN'A conversa inteira de um tíquete
curl 'https://api.picchat.com.br/v1/tickets/ID_DO_TIQUETE/messages?order=asc&limit=100' \
--header 'Authorization: Bearer SEU_TOKEN'Contatos de uma etapa do funil, com as propriedades
curl 'https://api.picchat.com.br/v1/contacts?property.etapa_do_funil=lead&include_properties=true' \
--header 'Authorization: Bearer SEU_TOKEN'Resultado de uma automação
curl 'https://api.picchat.com.br/v1/automations/ID_DA_AUTOMACAO' \
--header 'Authorization: Bearer SEU_TOKEN'A resposta traz total, delivered, read, replied, error e os tempos médios até a leitura e a resposta.
Sincronização incremental
Para copiar tíquetes para o seu sistema sem reler tudo, guarde a data da última sincronização e peça só o que mudou depois dela:
curl 'https://api.picchat.com.br/v1/tickets?updated_from=2026-11-08T12:00:00Z&sort=updated_at&order=asc&limit=100' \
--header 'Authorization: Bearer SEU_TOKEN'Permissões e canais
Cada rota exige uma permissão do grupo do usuário do token (mostrada em cada página da API Reference). Usuário vinculado a canais só lê tíquetes, mensagens e notas desses canais. Detalhes em Autenticação e tokens.
Paginação, filtros de data e ordenação seguem o mesmo padrão em todas as listagens — veja Paginação e filtros.