Palloo Developers
Build bots and apps for Palloo
Palloo has bot accounts, incoming webhooks, slash commands and Log in with Palloo. If you have built for Discord before, most of it will feel familiar.
- Getting started Create a bot, add it to a server and send its first message.
- Gateway Receive messages, members and interactions in real time over a WebSocket.
- Slash commands Register commands and answer them, in public or only to the person who asked.
- Incoming webhooks Post into a channel from any service with one secret URL.
What you can build
- Bots. A bot is an account that your program runs. It joins servers, receives events in real time over the gateway, and calls the same REST API as the Palloo app: it can send messages, manage channels and roles, moderate members and more, limited by the permissions a server gives it.
- Slash commands. A bot registers commands that people pick from a list when they type
/in a channel. Palloo checks the options, then hands your bot an interaction to answer, either in public or only to the person who asked. - Incoming webhooks. A webhook is a secret URL that posts messages into one channel. It needs no account and no connection, which makes it a good fit for alerts from CI, monitoring or a form on your website.
- Log in with Palloo. Websites can let people sign in with their Palloo account through OpenID Connect.
How the pieces fit
| You want to | Use |
|---|---|
| Post a message when something happens elsewhere | An incoming webhook |
| React to messages, members joining or other events | A bot connected to the gateway |
| Give people commands to run | A bot with slash commands |
| Know who a visitor to your site is | Log in with Palloo |
Things to know first
- The REST API lives at
https://api.palloo.app/v1and the gateway atwss://api.palloo.app/v1/gateway. Every path in these docs and the API reference is relative to that base URL:GET /instancemeansGET https://api.palloo.app/v1/instance. The older address,https://app.palloo.app/api/v1, still works with the same tokens and rate limits, but usehttps://api.palloo.app/v1in new code. - Bodies are JSON, IDs are 26 character ULIDs that sort by creation time, and permissions are 64-bit numbers sent as decimal strings.
- What people see as a server is a community in the API (
community_id,/communities/{id}). - Bots authenticate with
Authorization: Bearer <token>, the same header people's sessions use. See Authentication. - There is no official SDK yet. Every example here uses plain HTTP and a WebSocket, so any language works.
- Coming from Discord? Read Differences from Discord before you port a bot.
Next steps
Start with Getting started: create a bot, add it to a server and send its first message in a few minutes.