---
title: Webhooks
slug: aura/webhooks
createdAt: 2026-11-19T14:33:14.490Z
---

**Webhooks** é a tela onde você vê, em tempo real, tudo que os provedores dos canais mandam para a plataforma — inclusive os erros. É a ferramenta de diagnóstico quando algo não chega ou não funciona num canal.

:inlineImage[]{src="https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/voXO1ZzAderpmkEjzdCST_cb2edb71ccd425a9ab76f4cf45df2c32.jpg" alt="Cada linha é uma chamada recebida de um provedor" caption size="160" width="1600" height="911"} *Cada linha é uma chamada recebida de um provedor*

## Para que serve

Toda vez que um cliente manda uma mensagem por um canal (WhatsApp, Instagram, etc.), o provedor "avisa" a plataforma por um webhook. Esta tela mostra essas chamadas conforme elas chegam, com:

- data e horário da chamada;
- canal (de qual provedor veio);
- método e status (deu certo ou deu erro);
- um resumo e, ao expandir, o conteúdo completo da chamada.

A lista traz as **últimas 300 chamadas**: as mais antigas saem conforme chegam novas. O topo mostra o período que elas cobrem, da mais antiga à mais nova.

## Como usar para diagnosticar

1. Abra a tela **Webhooks** (deixe o modo **Ao vivo** ligado).
2. Peça para alguém mandar uma mensagem no canal — ou mande você mesmo.
3. Veja a chamada aparecer na lista na hora.
4. Se aparecer em vermelho (erro), clique para expandir e ver o motivo.

## Ver o que chegou de verdade

Cada linha da lista abre com **Ver o payload completo desta chamada**: o corpo exato que a plataforma recebeu (ou enviou), sem resumo. **Fechar detalhes** volta à lista. Também há **Atualizar agora**, para não esperar o refresco automático quando você está testando uma integração do outro lado.

## Filtros

Use os filtros do topo para achar rápido:

- por **canal** (mostrar só WhatsApp, por exemplo);
- por **método** (GET / POST);
- por **status** (só sucesso ou só erros);
- **busca** por texto (canal, resumo, erro, IP, corpo).
