> For the complete documentation index, see [llms.txt](https://docs.17movement.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.17movement.net/vending-machines/discord-webhooks.md).

# 🌐 Discord Webhooks

Vending Machines can send selected vending activity to Discord using configurable webhook URLs.

Webhook configuration is stored in:

```
configs/ApiKeys.lua
```

### Main settings

`Config.Webhooks` contains:

| Option    | Purpose                              |
| --------- | ------------------------------------ |
| `Enabled` | Enables or disables webhook logging. |
| `Name`    | Name displayed by the webhook.       |
| `Color`   | Embed color.                         |
| `Urls`    | Per-event webhook URLs.              |

### Supported webhook events

You can configure separate URLs for:

* `OrderPlaced`
* `DeliveryStarted`
* `DeliveryFinished`
* `Purchase`
* `Restock`

If an event URL is empty, that event is skipped.

### Customizing embeds

Webhook embed layout can be edited in:

```
server/webhook/webhook.lua
```

{% hint style="info" %}
`configs/ApiKeys.lua` and `server/webhook/webhook.lua` are outside escrow and can be customized.
{% endhint %}