integration-docs: Update Zendesk for new doc format.

Part of zulip #29592.

Co-authored-by: Lauryn Menard <lauryn@zulip.com>

templates/zerver/integrations/include/append-channel-name.md

@@ -1,3 +1,4 @@
-To specify the channel, you must explicitly append
+* To specify a Zulip channel for these notifications, you must explicitly
-`&stream=channel_name` to the end of the above URL, where
+  append `&stream=channel_name` to the end of the webhook URL constructed
-`channel_name` is the channel you want the notifications sent to.
+  above, where `channel_name` is the channel you want the notifications
+  sent to.

zerver/webhooks/zendesk/doc.md

@@ -1,56 +1,50 @@
+# Zulip Zendesk integration
+
+Get notifications about Zendesk tickets in Zulip!
+
+{start_tabs}
+
 1. {!create-channel.md!}
 
 1. {!create-an-incoming-webhook.md!}
 
-1. Construct a webhook URL like the following:
+1. {!generate-webhook-url-basic.md!}
 
-    `{{ api_url }}/v1/external/zendesk?ticket_title={% raw %}{{ ticket.title }}&ticket_id={{ ticket.id }}{% endraw %}`
+1. Append `{%raw%}&ticket_title={{ ticket.title }}&ticket_id={{ ticket.id }}{%endraw%}`
+   to the URL generated above.
 
-1. {!append-channel-name.md!}
+1. In Zendesk, click the **gear** (<i class="fa fa-cog"></i>) icon in the
+    bottom-left corner. Click on **Extensions**, and then click **add
+    target**.
 
-1. Next, in Zendesk, open your **Admin** view via gear in the bottom-left
+1. Click the **URL target**, and fill in the form with the following:
-    corner. In the **Admin** view, click on **Extensions**, then click
-    **add target**.
-
-    ![](/static/images/integrations/zendesk/001.png)
-    ![](/static/images/integrations/zendesk/002.png)
-
-1. From there, click **URL target**. Fill in the form like this:
 
     * **Title**: Zulip
-    * **URL**: the URL we created above
+    * **URL**: the URL generated and updated above
     * **Method**: POST
     * **Attribute Name**: message
     * **Username**: your bot's user name, e.g., `zendesk-bot@yourdomain.com`
     * **Password**: your bot's API key
 
-    ![](/static/images/integrations/zendesk/003.png)
+1. Select **Test Target**, and click **Submit**. A test message should
+   appear Zulip. Save the target by selecting **Create target**, and
+   clicking **Submit**.
 
-1. Now, select **Test Target** and click **Submit**. A test message should
+1. Add a new trigger, for every action you'd like to be notified about.
-    appear in the `zendesk` channel. If the message was received, save the
+   To add a trigger, select **Triggers** in the left menu, and click
-    target by selecting **Create target** and clicking **Submit**.
+   **add trigger**.
 
-1. From here, add a new trigger. You'll do this for every action you want
+1. Give the trigger a descriptive title (e.g., "Announce ticket update").
-    to create a Zulip notification for. Triggers are added by selecting
+   Under **Meet all of the following conditions**, select the conditions
-    **Triggers** in the left menu and then clicking **add trigger** in the
+   for the trigger. In the **Perform these actions** section, select
-    top right.
+   **Notification: Notify target**, and select the target created above
+   (e.g., "Zulip").
 
-    ![](/static/images/integrations/zendesk/004.png)
+1. Enter the message body into the **Message** field. You can use both
-    ![](/static/images/integrations/zendesk/005.png)
+   Zulip Markdown and Zendesk placeholders. Here's an example message
+   body template that you can optionally use:
 
-1. Let's say you want a notification each time a ticket is updated. Put
+        {% raw %}Ticket [#{{ ticket.id }}: {{ ticket.title }}]({{ ticket.link }}), was updated by {{ current_user.name }}
-    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 }}
@@ -59,13 +53,16 @@
         * Description:
         ``` quote
         {{ ticket.description }}
-        ```
+        ```{% endraw %}
-        {% endraw %}
 
-    ![](/static/images/integrations/zendesk/006.png)
+1.  Click **Submit**.
 
-1. Finally, click **Submit**.
+{end_tabs}
 
 {!congrats.md!}
 
 ![](/static/images/integrations/zendesk/007.png)
+
+### Related documentation
+
+{!webhooks-url-specification.md!}