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**,
+{start_tabs}
-   click on **Dispatch'r**. Click on **New rule**.
 
-1. Set **Rule Name** to a name of your choice, such as `Zulip`. There isn't a shortcut
+1. Go to your Freshdesk **Admin** page.
-   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**,
+1. Under **Helpdesk Productivity**, select **Dispatch'r**, and then
-   and when the source **is not email**. Set up the **Conditions** for the
+   select **New rule**.
-   new rule, like so:
+
+1. Set **Rule Name** to a name of your choice, such as `Zulip`.
+
+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. Under **Actions**, set the **Select Action** dropdown to **Trigger
-   Set **Request Type** to **POST**, and set **Callback URL** to the URL
+   Webhook**.
-   constructed above.
 
-1. Check the **Requires Authentication** checkbox. Set **Username** to the email
+1. Set **Request Type** to **POST**, and set **Callback URL** to the URL
-   of the bot created above, and set **Password** to the bot's API key. Set
+   [generated above][create-bot].
-   **Encoding** to **JSON** and select the **Advanced** option. Copy and paste
+
-   the following JSON into the **Content** box:
+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**,
+### Get notifications for changes to existing Freshdesk tickets
-   click on **Observer**, and click on **New rule**.
+
+{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
+   to **Trigger Webhook**.
-   **Callback URL** to the URL constructed above.
 
-1. Check the **Requires Authentication** checkbox. Set **Username** to the email
+1. Set **Request Type** to **POST**, and set **Callback URL** to the URL
-   of the bot created above, and set **Password** to the bot's API key. Set
+   [generated above][create-bot].
-   **Encoding** to **JSON** and select the **Advanced** option. Copy and paste
+
-   the following JSON into the **Content** box:
+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