mirror of https://github.com/zulip/zulip.git
72 lines
2.5 KiB
Markdown
72 lines
2.5 KiB
Markdown
1. {!create-channel.md!}
|
|
|
|
1. {!create-an-incoming-webhook.md!}
|
|
|
|
1. Construct a webhook URL like the following:
|
|
|
|
`{{ api_url }}/v1/external/zendesk?ticket_title={% raw %}{{ ticket.title }}&ticket_id={{ ticket.id }}{% endraw %}`
|
|
|
|
1. {!append-channel-name.md!}
|
|
|
|
1. Next, in Zendesk, open your **Admin** view via gear in the bottom-left
|
|
corner. In the **Admin** view, click on **Extensions**, then click
|
|
**add target**.
|
|
|
|
|
|
|
|
|
|
1. From there, click **URL target**. Fill in the form like this:
|
|
|
|
* **Title**: Zulip
|
|
* **URL**: the URL we created above
|
|
* **Method**: POST
|
|
* **Attribute Name**: message
|
|
* **Username**: *your bot's user name, e.g.* `zendesk-bot@yourdomain.com`
|
|
* **Password**: *your bot's API key*
|
|
|
|
|
|
|
|
1. Now, select **Test Target** and click **Submit**. A test message should
|
|
appear in the `zendesk` channel. If the message was received, save the
|
|
target by selecting **Create target** and clicking **Submit**.
|
|
|
|
1. From here, add a new trigger. You'll do this for every action you want
|
|
to create a Zulip notification for. Triggers are added by selecting
|
|
**Triggers** in the left menu and then clicking **add trigger** in the
|
|
top right.
|
|
|
|
|
|
|
|
|
|
1. Let's say you want a notification each time a ticket is updated. Put
|
|
in a descriptive title like "Announce ticket update". Under **Meet all of
|
|
the following conditions** select **Ticket: is...** and then select
|
|
**Updated**. In the **Perform these actions** section, select
|
|
**Notification: Notify target**, then select **Zulip**.
|
|
|
|
1. Next we need to enter the message body into Message. You can use
|
|
Zulip Markdown and the Zendesk placeholders when creating your message.
|
|
|
|
You can copy this example template:
|
|
|
|
{% raw %}
|
|
Ticket [#{{ ticket.id }}: {{ ticket.title }}]({{ ticket.link }}), was updated by {{ current_user.name }}
|
|
* Status: {{ ticket.status }}
|
|
* Priority: {{ ticket.priority }}
|
|
* Type: {{ ticket.ticket_type }}
|
|
* Assignee: {{ ticket.assignee.name }}
|
|
* Tags: {{ ticket.tags }}
|
|
* Description:
|
|
``` quote
|
|
{{ ticket.description }}
|
|
```
|
|
{% endraw %}
|
|
|
|
|
|
|
|
1. Finally, click **Submit**.
|
|
|
|
{!congrats.md!}
|
|
|
|
|