> ## Documentation Index
> Fetch the complete documentation index at: https://docs.unicontrol.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Discord

> Envie notificações do Portal para um canal do Discord via webhook

# Discord

A integração Discord permite que o Portal envie **notificações** para um canal do Discord através de um **webhook**. É ideal para automações que precisam avisar times inteiros — alarmes, alertas de câmera, status de dispositivos.

## Pre-requisitos

* Servidor Discord com um canal onde você tenha permissão de administrador
* Um webhook criado no canal (**Editar Canal → Integrações → Webhooks → Novo webhook**)
* URL do webhook (começa com `https://discord.com/api/webhooks/...`)

## Configurar

<Steps>
  <Step title="Crie o webhook no Discord">
    No canal desejado, va em **Editar Canal → Integrações → Webhooks**, clique em **Novo webhook** e copie a URL.
  </Step>

  <Step title="Adicione a integração">
    Va em **Configurações → Integrações → Adicionar → Discord**.
  </Step>

  <Step title="Cole a URL do webhook">
    Insira a URL completa. O Portal valida a chamada e recupera o **nome do canal** para exibição.
  </Step>
</Steps>

## Recursos

* Serviço `discord.send_message` — chamável de automações, scripts e regras
* Canal virtual único por webhook — sem entidades nem hardware

## Como Funciona

A integração vive no **core** do Portal — não requer edge nem dispositivos físicos. Cada webhook adicionado é uma entrada independente, e a **reconfiguração** permite trocar a URL sem recriar a integração.

<Warning>
  A URL do webhook concede acesso total ao envio de mensagens no canal. Trate como um segredo — não compartilhe nem versione em código.
</Warning>