Skip to main content

​
Overview

Petto can create webhooks in a channel and send messages through them with a custom username or avatar. Webhooks created by Petto are managed per server and never expose their token in chat or the dashboard.

​
Commands

!wh is an alias for !webhook. The identifier can be the local number shown by !webhook list, the name of the webhook or the Discord webhook ID. These commands are prefix-only.
liam lists two webhooks, Petto Land News in #announcements and Event bot in #general, then sends a message through number 1

In Discord: the list of managed webhooks and a message sent through one with its own name.

liam creates the webhook Game night and Petto answers with its number 3 and the channel

In Discord: a new webhook in the channel where you write it, with its number.

liam sends a message through webhook 1 with the username Petto Land News and Petto answers with a link to it

In Discord: a message through webhook 1 with another name, and a link to it.

The message posted by the webhook with its own name in #announcements

In Discord: what the webhook posts in #announcements.

liam sends a message with --add and an embed code with a title and a description

In Discord: --add puts an embed with a title and a description under the text.

The webhook message in #announcements with the text and an embed

In Discord: the text and the embed, as the webhook posts them.

liam edits a webhook message by its link and Petto answers that it was edited through Petto Land News

In Discord: a message the webhook sent, changed in place.

liam runs !webhook delete 2 and Petto answers that the webhook Event bot was deleted

In Discord: the webhook is deleted in Discord and in Petto.

!webhookconfig (needs Manage Server) lists the managed webhooks of the server with their channel and state, and every !webhook command.
liam runs !webhookconfig: two managed webhooks, both on, and the list of !webhook commands

In Discord: !webhookconfig, the managed webhooks and the commands.

​
Permissions and dashboard

You need Manage Webhooks to use the command. The webhook must also be created in a channel where Petto can manage webhooks.
Rex types !webhook list and Petto answers that the manage_webhooks permission is missing

In Discord: a member without Manage Webhooks cannot use !webhook.

The Managed webhooks card of Dashboard → Integrations → Webhooks can create, send, and delete managed webhooks. Tokens are kept server-side and are not rendered in the dashboard.
The Webhooks page of Petto Land with two managed webhooks, the create form and the three modes to send a message

Dashboard → Integrations → Webhooks: the managed webhooks, the form to create one and the Send a message form.

Each managed webhook has independent defaults for username, avatar URL, and message. Webhooks can be edited, duplicated, enabled or disabled, and sent with a per-message username/avatar override.
The webhook Petto Land News open for editing, with its default username, avatar and message, the Enabled box and Duplicate

Dashboard → Integrations → Webhooks: a webhook opened with Edit, with its name, default username, avatar and message.

The create form: channel, webhook name, default username, default avatar URL and Create

Dashboard → Integrations → Webhooks: the form to create a webhook.

​
Ways to send from the dashboard · New

The Send a message form of the dashboard has three modes:
  • Text and embed. The message, a username and an avatar for this send, and an embed with title, description, color, image, thumbnail, footer and a link on the title.
  • Saved design. Pick a design from the Embeds page and Petto sends it with its variables filled in. Components V2 designs work too.
  • Edit a sent message. Paste the ID of a message this webhook sent, write the new text or pick a design, and the message is changed in place.
The Send a message form on Text and embed: the webhook, the message, the sender and the embed

Dashboard → Integrations → Webhooks: Send a message, with Text and embed.

The Send a message form on Saved design, with the menu to pick a saved design

Dashboard → Integrations → Webhooks: Send a message, with a Saved design.

The Send a message form on Edit a sent message, with the field for the ID of the message

Dashboard → Integrations → Webhooks: Send a message, on Edit a sent message.

More options lets you send into a thread (paste the thread ID), start a forum post with a title, send the message silently, and allow pings. Pings are off by default: a webhook message does not mention @everyone, roles or members unless you tick the option.
More options open: the thread ID, the title of a forum post and the boxes to send silently and to allow pings

Dashboard → Integrations → Webhooks: More options: a thread, a forum post, silent and pings.

​
Embed additions

--add accepts a compact embed code. Petto currently reads title and description values, for example: