Pular para o conteúdo principal
Abra Logs para investigar a atividade operacional. Abra Configurações → Atividade para inspecionar as alterações feitas por pessoas e credenciais da sua equipe.

Investigue os logs

Escolha Todos, Requisições de API, Webhooks ou Sessões. Use Somente erros para restringir qualquer visualização às falhas. As linhas mostram data e hora precisas, origem, resumo, detalhes e status. Os detalhes de uma requisição incluem a duração ou um código de falha; os detalhes de uma entrega incluem o número de tentativas e o status HTTP. Os métodos da API têm cores distintas. A barra lateral contém os filtros de linha do tempo e de propriedades. No celular, abra Filtros para usar os mesmos controles. A busca sugere as propriedades compatíveis com o tipo de log selecionado. Selecione uma sugestão, digite um valor e pressione Enter para transformá-la em uma pílula de filtro. Clique em uma pílula para editá-la ou use o botão de fechar dela para removê-la. Valores da mesma propriedade funcionam como alternativas; propriedades diferentes precisam corresponder todas. Redefinir limpa os filtros, a busca e o contexto de evento e restaura a linha do tempo do último dia. Os identificadores de filtro aparecem quando a origem selecionada os aceita, incluindo IDs de requisição, sessão, evento, webhook, cliente, número e conversa. Um identificador só fica disponível quando a atividade correspondente o registra. Use Ordenar ou o cabeçalho de uma coluna para adicionar propriedades de ordenação. As pílulas de ordenação aparecem abaixo da busca, em ordem de prioridade. Clique em Ordenar para ocultar ou mostrar as pílulas sem perder a ordenação ativa. Clique em uma pílula para mudar a direção dela ou remova-a com o botão de fechar. Arraste as bordas das colunas para redimensioná-las; o navegador lembra essas larguras.

Linha do tempo e modo ao vivo

O botão de calendário à esquerda abre a seleção de datas. Clique em uma data de início e depois em uma data de término. Clique no mês ou no ano para ir para outro mês ou ano. Selecione Local ou UTC e depois Aplicar. Datas anteriores ao primeiro log retido, datas depois de hoje e dias sem atividade registrada ficam desativados. O menu suspenso à direita seleciona um período relativo: os últimos 30 minutos, a última hora, as últimas 12 horas, o último dia, os últimos três dias, a última semana ou as últimas duas semanas. Ele também substitui um intervalo de datas personalizado por um período relativo. O calendário continua disponível ao lado de um período selecionado. Ao vivo atualiza a cada três segundos. Um aviso de modo ao vivo aparece acima das linhas, e o ícone de atualização gira enquanto uma atualização está em andamento. As janelas relativas avançam a cada atualização; as janelas personalizadas mantêm as datas selecionadas. Atualizar busca novos resultados quando você quiser. Passe o mouse ou coloque o foco sobre um horário para ver o UTC, o horário local, o horário ISO e o tempo decorrido, que é atualizado a cada segundo enquanto o popup está aberto. O servidor retorna os 500 logs correspondentes mais recentes na janela selecionada, com 50 linhas por página da tabela. Restrinja a linha do tempo ou os filtros quando a visualização atingir o limite. Um intervalo selecionado cobre no máximo 366 dias.

Detalhes e contexto

Selecione uma linha para ver os campos registrados. Em telas largas, o detalhe fica ao lado da tabela, para você inspecionar outra linha sem fechá-lo. Telas menores abrem o mesmo detalhe em uma gaveta. Feche o detalhe para voltar à tabela completa. Ver no contexto abre a atividade de até cinco minutos antes e depois desse registro, em todas as origens. Registros com um ID de sessão também restringem o contexto a essa sessão. Limpe o contexto para voltar à janela do último dia. As atualizações de sessão incluem os estados de conexão registrados, os motivos de desconexão, o fim de banimentos temporários, os prazos de telefone offline e as mudanças de restrição. Esses fatos continuam disponíveis independentemente da retenção do corpo das mensagens. Os dados de pareamento e o conteúdo das mensagens ficam fora desses fatos de estado. Quando a sua equipe usa o beta de acompanhamentos de campanha, os acompanhamentos aparecem em Todos como linhas de Campanha, uma para cada mudança de estado de um acompanhamento, como campaign.followup.scheduled ou campaign.followup.cancelled. Os detalhes incluem os IDs da campanha, do destinatário, do acompanhamento, do número e do comando e um motivo como reply ou opt_out, nunca números de telefone nem o texto da mensagem. Acompanhamentos com falha e com resultado desconhecido também aparecem em Somente erros. Os destinos de logs não encaminham essas linhas. Consulte Envie um acompanhamento após a entrega ou a leitura. Os detalhes de webhook mostram as tentativas registradas, o status HTTP, o código de falha e trechos da resposta de falha com dados sensíveis ocultados. O corpo do evento vinculado só é carregado quando você abre o detalhe, e apenas enquanto essa carga continuar disponível de acordo com a configuração de armazenamento de mensagens do número de origem. O detalhe explica cargas indisponíveis ou expiradas. Os logs do projeto não incluem as cargas das requisições, as credenciais nem os cabeçalhos das requisições. Requisições de API com falha e entregas de webhook podem incluir um trecho da resposta de até 8 KB, depois que os campos comuns de credenciais são ocultados. Tipos de conteúdo de resposta não compatíveis são omitidos. Os registros operacionais brutos usam destaque de sintaxe. Uma requisição de API com falha retorna um request_log_url no corpo do erro. Esse link filtra Requisições de API pelo ID da requisição nos últimos sete dias. O ID corresponde ao cabeçalho de resposta X-Request-Id. Mostrar todos os eventos remove essa restrição à requisição vinculada.

Inspecione o histórico de auditoria

Configurações → Atividade lista até 500 ações da sua equipe ou do projeto selecionado. Filtre por ator, ação, origem, resultado, intervalo de datas ou busca. As fotos e os nomes de exibição dos atores aparecem quando a conta do ator os fornece; as iniciais servem de fallback. Abra uma linha para ver o e-mail do ator, a ação, o recurso, o resultado, as informações registradas da requisição e as alterações de campo antes e depois. Os detalhes de auditoria apresentam campos estruturados, sem uma visualização do registro bruto.

Exporte ou encaminhe

O menu de exportação abre imediatamente. Copiar logs visíveis, Exportar CSV e Exportar JSON usam as linhas filtradas e ordenadas da tabela carregada. O histórico de auditoria também exporta os registros filtrados e ordenados como CSV ou JSON. Proprietários e administradores do projeto usam Amostragem de rastros para configurar a amostragem dos registros operacionais encaminhados e Adicionar destino no menu de exportação para configurar um destino. A amostragem mantém completos os logs armazenados e o histórico de auditoria. Consulte Encaminhamento de logs para ver a configuração, as regras de amostragem e a verificação de entrega. Consulte a visão geral do produto Logs para uma introdução visual.