Conta
Consultar a conta do token
https://api.picchat.com.br/v1/meDevolve a conta dona do token com plano, saldos de créditos e totais de canais e usuários. O campo access diz quem é o usuário por trás do token, seus grupos e permissões, o escopo de canais e, em routes, quais consultas do /v1 ele pode fazer. Não exige permissão: serve para descobrir o que o token alcança antes de chamar as outras rotas.
Respostas
200OK
idstring (uuid)obrigatórioID da conta.
namestringobrigatórioNome da conta.
subdomainstringobrigatórioSubdomínio.
account_typestringobrigatórioSTANDARD ou INFRA (INFRA não usa /v1).
STANDARDINFRAactiveboolean | nullobrigatórioConta ativa.
payment_statusstringobrigatórioSituação de pagamento.
pendingpaidoverduecreditsintegerobrigatórioSaldo de créditos do plano.
whatsapp_official_creditsintegerobrigatórioCréditos bônus de WhatsApp oficial.
whatsapp_lite_creditsintegerobrigatórioCréditos bônus de WhatsApp Lite.
sms_creditsintegerobrigatórioCréditos bônus de SMS.
email_creditsintegerobrigatórioCréditos bônus de e-mail.
credit_renewal_datestring (date-time) | nullobrigatórioPróxima renovação dos créditos do plano.
created_atstring (date-time)obrigatórioCriação.
planobject | nullobrigatórioPlano atual.
plan.idstring (uuid)obrigatórioID do plano.
plan.namestringobrigatórioNome do plano.
plan.plan_groupstring | nullobrigatórioGrupo do plano.
channels_countintegerobrigatórioCanais não excluídos.
users_countintegerobrigatórioUsuários de origem não excluídos.
accessobjectobrigatórioQuem é o usuário do token e o que ele pode consultar.
access.enforcedbooleanobrigatórioSe as permissões estão sendo aplicadas a este token. false = modo observe (token de integração da conta durante a transição): nada é negado, só registrado.
access.viastring | nullobrigatórioComo o usuário foi identificado: JWT de sessão, token de integração ou token pessoal. null = token sem usuário ativo.
sessionintegrationpersonalnullaccess.userobject | nullobrigatórioUsuário por trás do token.
access.user.idstring (uuid)obrigatórioID do usuário.
access.user.namestringobrigatórioNome completo.
access.user.emailstring | nullobrigatórioE-mail.
access.adminbooleanobrigatórioUsuário sem grupo de permissão na conta de origem = administrador (vê tudo).
access.permission_groupsarray<string>obrigatórioNomes dos grupos de permissão do usuário nesta conta.
access.permissionsarray<string>obrigatórioPermissões `recurso:ação` (ex.: `inbox:read`). Admin recebe `["*"]`.
access.channel_scopestring | array<ChannelRefShort>obrigatório`"all"` ou a lista de canais a que o usuário está restrito (tíquetes, mensagens e notas só desses canais).
access.routesobjectobrigatórioPor chave de rota (me, tickets, messages, notes, ticket-status, contacts, contact-tickets, lists, list-contacts, properties, tags, campaigns, automations, channels, templates, users, assistants, knowledge-bases): se o usuário pode consultá-la.
403Acesso negado: `account_id` na query diferente da conta do token; conta do tipo INFRA.
404Registro não existe, é de outra conta, foi excluído ou está fora do escopo de canais do usuário.
498Token ausente, inválido, de outra finalidade (ex.: token do canal chat) ou revogado. Note o status não padrão 498.