Planos que suportam este recurso: Professional Business Enterprise
Um Webhook é um método de envio automático de dados em tempo real de um aplicativo para outro quando ocorrem eventos específicos. Os webhooks no Document360 permitem que você envie notificações para outros aplicativos, mantendo sua equipe atualizada sobre as alterações no portal, site ou widget da base de conhecimento.
Por exemplo, sua equipe de suporte usa uma ferramenta de comunicação como o Slack. Ao configurar um Webhook, você pode notificar instantaneamente a equipe quando um artigo é atualizado, garantindo que todos tenham as informações mais recentes sem precisar verificar manualmente se há atualizações.
Configurando um canal de notificação de webhook
Para configurar um canal de notificação de webhook no Document360, siga as etapas abaixo:
Navegue até Configurações () na barra de navegação esquerda no portal da Base de conhecimento.
No painel de navegação esquerdo, navegue até Portal da base de conhecimento > Notificações.
Por padrão, a guia Canais de notificação será selecionada.
Clique em Novo canal.
No painel Canais disponíveis , selecione Webhook e clique em Avançar.
O painel Configuração do canal será exibido.
No campo Nome amigável , insira um nome exclusivo para seu canal de webhook.
No menu suspenso Método de solicitação , selecione POST ou PUT, dependendo de como você deseja enviar os dados.
No campo URL do Webhook , insira a URL do aplicativo para o qual você deseja enviar notificações.
Escolha o formato de mensagem desejado no menu suspenso Conteúdo da solicitação .
Se forem necessários cabeçalhos adicionais, clique em Adicionar novo () em Cabeçalhos padrão e adicione-os.
Opcionalmente, insira a chave de autorização se o aplicativo de recebimento exigir autenticação.
Clique em Salvar.
NOTA
Para obter mais informações, consulte Request header.
Depois de salvar, um novo canal de notificação de Webhook com o nome especificado é criado. Agora, navegue até a guia Notification mapping para mapear as configurações com seu aplicativo Webhook com base em seus requisitos.
Perguntas Freqüentes
Quais informações estão incluídas em uma notificação de Webhook?
Quando um Webhook é acionado, o Document360 envia uma carga JSON estruturada para a URL configurada. A carga contém detalhes do evento, o usuário que executou a ação e metadados sobre o artigo ou projeto.
Você pode me mostrar um exemplo de carga útil?
Sim. Abaixo está um exemplo de conteúdo para o evento "Artigo publicado" :
{
"Knowledge base name": "Document360 2.0",
"Event": "Article published",
"User": "Matt sterling",
"User email": "matt.sterling@document360.co",
"Logged on (UTC)": "09/12/2025 06:01:04",
"Article name": "Webhook notification test",
"Article id": "e1444f0x-0xx0-000x-xxx0-0x3f2bc3713c",
"Article URL": "https://Document3602.0/document360.io/docs/en/webhook-notification-test",
"Language": "English",
"Project version id": "55144000-0xxx-000x-0000-0x2346b3bms3",
"Language code": "en"
}Os campos na carga são:
Nome da base de dados de conhecimento: o nome do projeto da base de dados de conhecimento.
Evento: o tipo de ação que acionou o Webhook (por exemplo, artigo publicado).
Usuário/E-mail do usuário: o membro da equipe que executou a ação.
Conectado (UTC): Data e hora da ação, em UTC.
Nome do artigo / ID do artigo / URL do artigo: detalhes e link para o artigo afetado.
Idioma / Código do idioma: O idioma do artigo.
ID da versão do projeto: identificador para a versão da base de dados de conhecimento.
As cargas diferem para outros eventos (por exemplo, artigo atualizado, excluído)?
Sim, a estrutura da carga permanece semelhante, mas o campo Evento muda dependendo da ação, por exemplo, Artigo atualizado ou Artigo excluído. Não apenas o campo do evento, mas outros campos, como detalhes do usuário, detalhes do artigo e versão do projeto, também podem variar. Por exemplo:
{
"Knowledge base name": "Document360 2.0",
"Event": "Extension token deleted",
"User": "Matt sterling",
"User email": "matt.sterling@document360.co",
"Logged on (UTC)": "09/12/2025 06:47:10",
"Extension": "MAKE"
}{
"Knowledge base name": "Document360 2.0",
"Event": "Widget setting created",
"User": "Matt sterling",
"User email": "matt.sterling@document360.co",
"Logged on (UTC)": "09/12/2025 06:47:36",
"Widget setting name": "Knowledge base widget"
}{
"Knowledge base name": "Document360 2.0",
"Event": "Drive folder added",
"User": "Matt sterling",
"User email": "matt.sterling@document360.co",
"Logged on (UTC)": "09/12/2025 06:48:08",
"Folder name": "Media"
}