mirror of
https://github.com/zulip/zulip.git
synced 2025-11-03 13:33:24 +00:00
help: Document bot types in add-a-bot-or-integration.
This commit is contained in:
Binary file not shown.
|
Before Width: | Height: | Size: 20 KiB After Width: | Height: | Size: 20 KiB |
@@ -7,8 +7,9 @@ Bots and integrations are features that are accessible to all members of an orga
|
||||
{!go-to-the.md!} [Your bots](/#settings/your-bots)
|
||||
{!settings.md!}
|
||||
|
||||
2. On this page, under the **Add a new bot** view, you can enter a name, an email, and
|
||||
optionally an avatar for your bot. Then click the **Create bot** button to create your bot.
|
||||
2. On this page, under the **Add a new bot** view, enter the bot type,
|
||||
a name, an email, and optionally an avatar for your bot.
|
||||
Then click the **Create bot** button to create your bot.
|
||||
|
||||

|
||||
|
||||
@@ -22,6 +23,25 @@ configuration file (`.zuliprc`) which you will need for integrations that you wo
|
||||
to use with this bot. You can click on the download
|
||||
(<i class="icon-vector-download-alt"></i>) icon to download your `.zuliprc` file.
|
||||
|
||||
### Bot types
|
||||
|
||||
You can create three types of bots:
|
||||
|
||||

|
||||
|
||||
* **Generic bot:** A generic bot can send *and* receive messages.
|
||||
|
||||
* **Incoming webhook:** The API keys for such bots are limited to
|
||||
only sending messages and can't receive messages. Thus, this bot
|
||||
type lessens the security risks associated with exposing such API
|
||||
keys to third-party services, since they can't be used to read
|
||||
messages.
|
||||
|
||||
* **Outgoing webhook:** Bots of this type are the same as a
|
||||
**Generic bot**, except **Outgoing webhooks** bots have an extra field
|
||||
for the base URL of the third-party service being requested.
|
||||
**Outgoing webhook** bots send POST requests to this base URL.
|
||||
|
||||
## Add an integration
|
||||
|
||||
The [Integrations page](/integrations) offers a complete list of all the
|
||||
|
||||
Reference in New Issue
Block a user