integration-docs: Update Freshdesk for new doc format.

Revises doc to have three instructions sections. One for creating
the Zulip bot and webhook URL. One for adding notifications for
new Freshdesk tickets. And one for getting notifications for
existing Freshdesk tickets.

Part of #29592.

zerver/webhooks/freshdesk/doc.md

@@ -1,33 +1,52 @@
+# Zulip Freshdesk integration
+
 See customer support interactions in Zulip with our Freshdesk
 integration!
 
+### Create Zulip bot for Freshdesk notifications
+
+{start_tabs}
+
 1. {!create-channel.md!}
 
 1. {!create-an-incoming-webhook.md!}
 
-1. {!generate-integration-url.md!}
+1. {!generate-webhook-url-basic.md!}
+
+{end_tabs}
+
 
 ### Add notifications for new Freshdesk tickets
 
-1. Go to your Freshdesk **Admin** page. Under **Helpdesk Productivity**,
-   click on **Dispatch'r**. Click on **New rule**.
+{start_tabs}
 
-1. Set **Rule Name** to a name of your choice, such as `Zulip`. There isn't a shortcut
-   for "always generate a notification on ticket creation", so we'll have to
-   fake it by picking two complementary conditions: when the source **is email**,
-   and when the source **is not email**. Set up the **Conditions** for the
-   new rule, like so:
+1. Go to your Freshdesk **Admin** page.
 
-    ![](/static/images/integrations/freshdesk/001.png)
+1. Under **Helpdesk Productivity**, select **Dispatch'r**, and then
+   select **New rule**.
 
-1. Under **Actions**, set the **Select Action** dropdown to **Trigger Webhook**.
-   Set **Request Type** to **POST**, and set **Callback URL** to the URL
-   constructed above.
+1. Set **Rule Name** to a name of your choice, such as `Zulip`.
 
-1. Check the **Requires Authentication** checkbox. Set **Username** to the email
-   of the bot created above, and set **Password** to the bot's API key. Set
-   **Encoding** to **JSON** and select the **Advanced** option. Copy and paste
-   the following JSON into the **Content** box:
+1. There isn't a shortcut to "always generate a notification on ticket
+   creation", so we'll have to fake it by picking two complementary
+   conditions: when the source **is email**, and when the source **is
+   not email**. Set up the **Conditions** for the new rule, like so:
+
+     ![](/static/images/integrations/freshdesk/001.png)
+
+1. Under **Actions**, set the **Select Action** dropdown to **Trigger
+   Webhook**.
+
+1. Set **Request Type** to **POST**, and set **Callback URL** to the URL
+   [generated above][create-bot].
+
+1. Toggle the **Requires Authentication** checkbox.
+
+1. Set **Username** to the email of the bot [created above][create-bot],
+   and set **Password** to the bot's API key.
+
+1. Set **Encoding** to **JSON**, and select the **Advanced** option.
+   Copy and paste the following JSON into the **Content** box:
 
     ```
     {% raw %}
@@ -48,15 +67,22 @@ integration!
     {% endraw %}
     ```
 
-    Click **Save**.
+1. Click **Save**.
 
-### Get notifications for changes to existing tickets
+{end_tabs}
 
-1. Go to your Freshdesk **Admin** page. Under **Helpdesk Productivity**,
-   click on **Observer**, and click on **New rule**.
+### Get notifications for changes to existing Freshdesk tickets
+
+{start_tabs}
+
+1. Go to your Freshdesk **Admin** page.
+
+1. Under **Helpdesk Productivity**, select **Observer**, and then select
+   **New rule**.
 
 1. Set **Rule Name** to a name of your choice, such as `Zulip`.
-   Under **involves any of these events**, create new events as shown below:
+
+1. Under **involves any of these events**, create new events as shown below:
 
     ![](/static/images/integrations/freshdesk/002.png)
 
@@ -69,13 +95,18 @@ integration!
     ![](/static/images/integrations/freshdesk/003.png)
 
 1. Under **perform these actions**, set the **Select Action** dropdown
-   to **Trigger Webhook**. Set **Request Type** to **POST**, and set
-   **Callback URL** to the URL constructed above.
+   to **Trigger Webhook**.
 
-1. Check the **Requires Authentication** checkbox. Set **Username** to the email
-   of the bot created above, and set **Password** to the bot's API key. Set
-   **Encoding** to **JSON** and select the **Advanced** option. Copy and paste
-   the following JSON into the **Content** box:
+1. Set **Request Type** to **POST**, and set **Callback URL** to the URL
+   [generated above][create-bot].
+
+1. Toggle the **Requires Authentication** checkbox.
+
+1. Set **Username** to the email of the bot [created above][create-bot],
+   and set **Password** to the bot's API key.
+
+1. Set **Encoding** to **JSON** and select the **Advanced** option.
+   Copy and paste the following JSON into the **Content** box:
 
     ```
     {% raw %}
@@ -96,8 +127,16 @@ integration!
     {% endraw %}
     ```
 
-    Click **Save**.
+1. Select **Save**.
+
+{end_tabs}
 
 {!congrats.md!}
 
 ![](/static/images/integrations/freshdesk/004.png)
+
+### Related documentation
+
+{!webhooks-url-specification.md!}
+
+[create-bot]: #create-zulip-bot-for-freshdesk-notifications