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

# Webhook

> Crie webhooks que o Petto guarda para o seu servidor e publique por eles com qualquer nome e avatar, por um comando ou pelo dashboard, sem mostrar nenhum token.

## Visão geral

O Petto pode criar webhooks em um canal e enviar mensagens por eles com um nome de usuário ou avatar personalizado. Os webhooks criados pelo Petto são gerenciados por servidor e nunca expõem o token no chat nem no dashboard.

## Comandos

```javascript Sintaxe theme={null}
!webhook create <name>
!webhook send <identifier> <message> [--add <embed_code>] [--username <name>] [--avatar_url <url>]
!webhook edit <message_link> <new_message>
!webhook delete <identifier>
!webhook list
```

```javascript Exemplo theme={null}
!webhook create anúncios
!webhook send 1 "O evento começa em 10 minutos" --username "Notícias do Petto"
!webhook send 1 olá --add "{embed}$v{title: Boas-vindas}"
!webhook edit https://discord.com/channels/123/456/789 "Anúncio atualizado"
!webhook delete 1
```

`!wh` é um alias de `!webhook`. O identificador pode ser o número local mostrado pelo `!webhook list`, o nome do webhook ou o ID do webhook no Discord. Esses comandos só funcionam com prefixo.

![liam lista dois webhooks, Notícias do Petto Land no #anuncios e Bot de eventos no #general, e depois envia uma mensagem pelo número 1](https://mintcdn.com/wikipetto/ym43wKcqHRA_RnWi/images/discord/miscellaneous/pt-br/webhook.webp?fit=max\&auto=format\&n=ym43wKcqHRA_RnWi\&q=85\&s=2a960bc01fd87e2132c49a03f7a8aef1)

No Discord: a lista de webhooks gerenciados e uma mensagem enviada por um deles com o próprio nome.

> [accordion] !webhook create
>
> ![liam cria o webhook Noite de jogos e o Petto responde com o número 3 e o canal](https://mintcdn.com/wikipetto/W92wXuPUuDfMzVq7/images/discord/miscellaneous/pt-br/webhook-create.webp?fit=max\&auto=format\&n=W92wXuPUuDfMzVq7\&q=85\&s=1fce2eb97a8229d2774de119d9965f1a)
>
> No Discord: um webhook novo no canal onde você escreve, com o número.

> [accordion] !webhook send
>
> ![liam envia uma mensagem pelo webhook 1 com o nome Notícias do Petto Land e o Petto responde com um link](https://mintcdn.com/wikipetto/W92wXuPUuDfMzVq7/images/discord/miscellaneous/pt-br/webhook-send.webp?fit=max\&auto=format\&n=W92wXuPUuDfMzVq7\&q=85\&s=9187de64a4a7a41d8c9d1525e927a0a6)
>
> No Discord: uma mensagem pelo webhook 1 com outro nome, e um link para ela.
>
> ![A mensagem publicada pelo webhook com o próprio nome no #anuncios](https://mintcdn.com/wikipetto/W92wXuPUuDfMzVq7/images/discord/miscellaneous/pt-br/webhook-sent.webp?fit=max\&auto=format\&n=W92wXuPUuDfMzVq7\&q=85\&s=9d0fc8f7835aa95e027bf02642c9bac3)
>
> No Discord: o que o webhook publica no #anuncios.

> [accordion] !webhook send … --add
>
> ![liam envia uma mensagem com --add e um código de embed com título e descrição](https://mintcdn.com/wikipetto/W92wXuPUuDfMzVq7/images/discord/miscellaneous/pt-br/webhook-send-embed.webp?fit=max\&auto=format\&n=W92wXuPUuDfMzVq7\&q=85\&s=27cba10e4225a699e116619b8936b858)
>
> No Discord: --add coloca um embed com título e descrição embaixo do texto.
>
> ![A mensagem do webhook no #anuncios com o texto e um embed](https://mintcdn.com/wikipetto/W92wXuPUuDfMzVq7/images/discord/miscellaneous/pt-br/webhook-sent-embed.webp?fit=max\&auto=format\&n=W92wXuPUuDfMzVq7\&q=85\&s=0ce03f558185191a51aad96199d85a4b)
>
> No Discord: o texto e o embed, como o webhook publica.

> [accordion] !webhook edit
>
> ![liam edita uma mensagem do webhook pelo link e o Petto responde que ela foi editada](https://mintcdn.com/wikipetto/W92wXuPUuDfMzVq7/images/discord/miscellaneous/pt-br/webhook-edit.webp?fit=max\&auto=format\&n=W92wXuPUuDfMzVq7\&q=85\&s=cc897ecb8751fc2da9d01a926648c44d)
>
> No Discord: uma mensagem que o webhook enviou, mudada no lugar.

> [accordion] !webhook delete
>
> ![liam usa !webhook delete 2 e o Petto responde que o webhook Bot de eventos foi apagado](https://mintcdn.com/wikipetto/W92wXuPUuDfMzVq7/images/discord/miscellaneous/pt-br/webhook-delete.webp?fit=max\&auto=format\&n=W92wXuPUuDfMzVq7\&q=85\&s=727f65aa519a9d05a325372843f9a223)
>
> No Discord: o webhook é apagado no Discord e no Petto.

`!webhookconfig` (precisa de **Gerenciar servidor**) lista os webhooks gerenciados do servidor com o canal e o estado, e todos os comandos do `!webhook`.

![liam usa !webhookconfig: dois webhooks gerenciados, os dois ativados, e a lista de comandos do !webhook](https://mintcdn.com/wikipetto/W92wXuPUuDfMzVq7/images/discord/miscellaneous/pt-br/webhook-config.webp?fit=max\&auto=format\&n=W92wXuPUuDfMzVq7\&q=85\&s=5faa006e58f71ae07202cd236a00266b)

No Discord: !webhookconfig, os webhooks gerenciados e os comandos.

## Permissões e dashboard

Você precisa de **Gerenciar webhooks** para usar o comando. O webhook também precisa ser criado em um canal onde o Petto possa gerenciar webhooks.

![Rex escreve !webhook list e o Petto responde que falta a permissão manage\_webhooks](https://mintcdn.com/wikipetto/W92wXuPUuDfMzVq7/images/discord/miscellaneous/pt-br/webhook-no-permission.webp?fit=max\&auto=format\&n=W92wXuPUuDfMzVq7\&q=85\&s=29f7e5689cede8d14e9175b1f9accacc)

No Discord: um membro sem Gerenciar webhooks não pode usar o !webhook.

O card **Webhooks gerenciados** de **Dashboard → Integrações → Webhooks** pode criar, enviar e apagar webhooks gerenciados. Os tokens ficam guardados no servidor e não aparecem no dashboard.

![A página Webhooks do Petto Land com dois webhooks gerenciados, o formulário para criar e os três modos de enviar uma mensagem](https://mintcdn.com/wikipetto/PiFwt6dDUZHBNDT7/images/dashboard/miscellaneous/pt-br/webhook.webp?fit=max\&auto=format\&n=PiFwt6dDUZHBNDT7\&q=85\&s=ae64b84ea9ded4a460b3b45d351cb873)

Dashboard → Integrações → Webhooks: os webhooks gerenciados, o formulário para criar um e o formulário Enviar uma mensagem.

Cada webhook gerenciado tem padrões independentes de nome de usuário, URL do avatar e mensagem. Os webhooks podem ser editados, duplicados, ativados ou desativados, e enviados com um nome de usuário/avatar personalizado para cada mensagem.

![O webhook Notícias do Petto Land aberto para edição, com usuário, avatar e mensagem padrão, a caixa Ativado e Duplicar](https://mintcdn.com/wikipetto/VR-_hcmj859PB7OS/images/dashboard/miscellaneous/pt-br/webhook-dash-editor.webp?fit=max\&auto=format\&n=VR-_hcmj859PB7OS\&q=85\&s=d927188df0acd9636223b782db94aa49)

Dashboard → Integrações → Webhooks: um webhook aberto com Editar, com nome, usuário, avatar e mensagem padrão.

![O formulário de criação: canal, nome, usuário padrão, avatar padrão e Criar](https://mintcdn.com/wikipetto/VR-_hcmj859PB7OS/images/dashboard/miscellaneous/pt-br/webhook-dash-create.webp?fit=max\&auto=format\&n=VR-_hcmj859PB7OS\&q=85\&s=8d168fe24e16bba10a5ac8f26d7131c3)

Dashboard → Integrações → Webhooks: o formulário para criar um webhook.

### Formas de enviar pelo dashboard · Novo

O formulário **Enviar uma mensagem** do dashboard tem três modos:

* **Texto e embed.** A mensagem, um nome de usuário e um avatar para este envio, e um embed com título, descrição, cor, imagem, miniatura, rodapé e um link no título.
* **Design salvo.** Escolha um design da página **Embeds** e o Petto o envia com as variáveis preenchidas. Designs de Components V2 também funcionam.
* **Editar uma mensagem enviada.** Cole o ID de uma mensagem que este webhook enviou, escreva o novo texto ou escolha um design, e a mensagem é alterada no lugar.

> [accordion] Texto e embed
>
> ![O formulário Enviar uma mensagem em Texto e embed: o webhook, a mensagem, o remetente e o embed](https://mintcdn.com/wikipetto/VR-_hcmj859PB7OS/images/dashboard/miscellaneous/pt-br/webhook-dash-send-text.webp?fit=max\&auto=format\&n=VR-_hcmj859PB7OS\&q=85\&s=6b91c81e9cc7c6e56122597ee20ddf85)
>
> Dashboard → Integrações → Webhooks: Enviar uma mensagem, com Texto e embed.

> [accordion] Design salvo
>
> ![O formulário Enviar uma mensagem em Design salvo, com o menu para escolher um design salvo](https://mintcdn.com/wikipetto/VR-_hcmj859PB7OS/images/dashboard/miscellaneous/pt-br/webhook-dash-send-design.webp?fit=max\&auto=format\&n=VR-_hcmj859PB7OS\&q=85\&s=a2d2932528018ab051927f4963b3a4f6)
>
> Dashboard → Integrações → Webhooks: Enviar uma mensagem, com um Design salvo.

> [accordion] Editar uma mensagem enviada
>
> ![O formulário Enviar uma mensagem em Editar uma mensagem enviada, com o campo do ID da mensagem](https://mintcdn.com/wikipetto/VR-_hcmj859PB7OS/images/dashboard/miscellaneous/pt-br/webhook-dash-send-edit.webp?fit=max\&auto=format\&n=VR-_hcmj859PB7OS\&q=85\&s=ce7dbbdd38b493ef4106c5eaa11ecfc0)
>
> Dashboard → Integrações → Webhooks: Enviar uma mensagem, em Editar uma mensagem enviada.

**Mais opções** permite enviar em um tópico (cole o ID do tópico), começar uma publicação de fórum com um título, enviar a mensagem em silêncio e permitir menções. As menções vêm desativadas por padrão: uma mensagem de webhook não menciona `@everyone`, cargos nem membros, a menos que você marque a opção.

![Mais opções aberto: o ID do tópico, o título de uma publicação de fórum e as caixas para enviar em silêncio e permitir menções](https://mintcdn.com/wikipetto/VR-_hcmj859PB7OS/images/dashboard/miscellaneous/pt-br/webhook-dash-more.webp?fit=max\&auto=format\&n=VR-_hcmj859PB7OS\&q=85\&s=2626b21abfa1f1275738045e1dbb8374)

Dashboard → Integrações → Webhooks: Mais opções: um tópico, uma publicação de fórum, silenciosa e menções.

## Adições de embed

`--add` aceita um código de embed compacto. Atualmente o Petto lê os valores de `title` e `description`, por exemplo:

```javascript theme={null}
!webhook send 1 olá --add "{embed}$v{title: Olá}{description: Isto é um embed}"
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.