# Adzgrup API > API do Adzgrup para ler dados de atendimento a clientes em grupos de WhatsApp — grupos, conversas, pendências de resposta (SLA de 1ª resposta), assuntos, insights com evidência e métricas — e receber eventos por webhook. Base URL: https://api.adzgrup.com.br/v1. Especificação OpenAPI 3.1: https://api.adzgrup.com.br/v1/openapi.json. Documentação interativa: https://adzgrup.com.br/docs/api. Tudo em um arquivo: https://adzgrup.com.br/llms-full.txt. ## Começando - [Introdução](https://adzgrup.com.br/docs/api/introduction.md): O que a API do Adzgrup faz, autenticação, formato das respostas, limites e primeira chamada. - [Autenticação](https://adzgrup.com.br/docs/api/authentication.md): Chaves adz_live_…: como criar, enviar e revogar; o que cada chave enxerga. - [Respostas, erros e limites](https://adzgrup.com.br/docs/api/errors.md): Envelope success/data, treatedReason, códigos HTTP e limite de 120 req/min. ## Endpoints · Conversas - [GET /groups — Listar grupos](https://adzgrup.com.br/docs/api/endpoints/get-groups.md): Grupos acompanhados, com a última mensagem e desde quando o cliente espera resposta (`waitingSince`). - [GET /groups/{id} — Conversa de um grupo](https://adzgrup.com.br/docs/api/endpoints/get-groups-id.md): Mensagens em ordem de leitura, de 80 em 80. Para páginas anteriores, passe `before` = `sentAt` da primeira mensagem recebida. ## Endpoints · Atendimento - [GET /pending — Pendências de resposta](https://adzgrup.com.br/docs/api/endpoints/get-pending.md): Grupos em que um cliente pediu algo e a equipe ainda não respondeu, com o último aviso (resumo e sugestão). - [GET /team — Equipe e sugestões](https://adzgrup.com.br/docs/api/endpoints/get-team.md): Pessoas presentes nos grupos, papel atual (equipe/cliente) e sugestão por presença. ## Endpoints · Análise - [GET /topics — Listar assuntos](https://adzgrup.com.br/docs/api/endpoints/get-topics.md): Assuntos (threads) dos grupos, mais recentes primeiro. - [GET /topics/{id} — Assunto com os trechos](https://adzgrup.com.br/docs/api/endpoints/get-topics-id.md): Mensagens do assunto em ordem e o histórico de mudanças. - [GET /insights — Insights](https://adzgrup.com.br/docs/api/endpoints/get-insights.md): Achados das lentes (risco de churn, oportunidade, reclamação, qualidade do atendimento), sempre com as mensagens de evidência. - [GET /metrics — Catálogo de métricas](https://adzgrup.com.br/docs/api/endpoints/get-metrics.md): Métricas disponíveis e as dimensões permitidas em cada uma. - [POST /metrics/query — Calcular métrica](https://adzgrup.com.br/docs/api/endpoints/post-metrics-query.md): Calcula uma métrica do catálogo, opcionalmente quebrada por até 2 dimensões. `previous` traz o período anterior (só sem dimensão). - [POST /metrics/drill — Mensagens por trás de um número](https://adzgrup.com.br/docs/api/endpoints/post-metrics-drill.md): Mesma consulta + `point` (`{ dimensão: id }` de uma linha do resultado). Devolve até 50 mensagens ou assuntos. - [POST /assistant — Perguntar ao assistente](https://adzgrup.com.br/docs/api/endpoints/post-assistant.md): Pergunta em português sobre a operação. Usa IA (conta no uso do mês). Mande o histórico em `turns` para continuar a conversa. ## Webhooks - [Webhooks: configurar e validar](https://adzgrup.com.br/docs/api/webhooks.md): Receber eventos no seu sistema: configuração, corpo, headers e validação da assinatura HMAC. - [Evento alert.created](https://adzgrup.com.br/docs/api/webhooks/alert-created.md): Aviso de cliente esperando. Disparado em cada estágio do aviso (ex.: 15, 30 e 60 minutos úteis). - [Evento alert.resolved](https://adzgrup.com.br/docs/api/webhooks/alert-resolved.md): Cliente respondido. A equipe respondeu e a espera acabou (uma vez por espera). - [Evento insight.high](https://adzgrup.com.br/docs/api/webhooks/insight-high.md): Insight de gravidade alta. Uma lente encontrou algo grave e novo (ex.: risco de churn). ## Referência - [Métricas e dimensões](https://adzgrup.com.br/docs/api/metrics.md): Catálogo de métricas, dimensões, períodos e filtros para /metrics/query e /metrics/drill. - [Conceitos do domínio](https://adzgrup.com.br/docs/api/concepts.md): Equipe × cliente, espera de resposta, assuntos, lentes e insights, mídia e retenção de 90 dias. ## Objetos - [Objeto Group](https://adzgrup.com.br/docs/api/schemas/group.md): Campos do objeto Group. - [Objeto Message](https://adzgrup.com.br/docs/api/schemas/message.md): Campos do objeto Message. - [Objeto GroupDetail](https://adzgrup.com.br/docs/api/schemas/groupdetail.md): Campos do objeto GroupDetail. - [Objeto Pending](https://adzgrup.com.br/docs/api/schemas/pending.md): Campos do objeto Pending. - [Objeto Team](https://adzgrup.com.br/docs/api/schemas/team.md): Campos do objeto Team. - [Objeto Topic](https://adzgrup.com.br/docs/api/schemas/topic.md): Campos do objeto Topic. - [Objeto TopicDetail](https://adzgrup.com.br/docs/api/schemas/topicdetail.md): Campos do objeto TopicDetail. - [Objeto Insight](https://adzgrup.com.br/docs/api/schemas/insight.md): Campos do objeto Insight. - [Objeto Metric](https://adzgrup.com.br/docs/api/schemas/metric.md): Campos do objeto Metric. - [Objeto MetricResult](https://adzgrup.com.br/docs/api/schemas/metricresult.md): Campos do objeto MetricResult. - [Objeto DrillItem](https://adzgrup.com.br/docs/api/schemas/drillitem.md): Campos do objeto DrillItem. - [Objeto AssistantReply](https://adzgrup.com.br/docs/api/schemas/assistantreply.md): Campos do objeto AssistantReply.