Update webhooks section (#456)

Co-authored-by: Josef Válek <[email protected]>

Author: m-murasovs

content/docs/access_rights/organization_account.md

@@ -15,7 +15,7 @@ You can [switch]({{@link access_rights/organization_account/how_to_use.md#in-the
 You can set up an organization in two ways.
 
 * [Create a new organization](#create-a-new-organization). If you don't have integrations set up yet, or if they are easy to change, you can create a new organization, preserving your personal account.
-* [Convert an existing account](#convert-an-existing-account) into an organization. If your actors and [integrations]({{@link tutorials/integrations.md}}) are set up in a personal account, it is probably best to convert that account into an organization. This will preserve all your integrations but means you will have a new personal account created for you.
+* [Convert an existing account](#convert-an-existing-account) into an organization. If your actors and [integrations]({{@link integrations.md}}) are set up in a personal account, it is probably best to convert that account into an organization. This will preserve all your integrations but means you will have a new personal account created for you.
 
 > Prefer video to reading? [See our video tutorial](https://www.youtube.com/watch?v=BIL6HqtnvKk) for organization accounts.
 

content/docs/access_rights/organization_account/how_to_use.md

@@ -42,7 +42,7 @@ The organization, its actors and integrations will keep running as they are. The
 
 While you cannot manage an organization account's settings and members via API, you can access its actor and task runs, webhooks, schedules and storages just like you would with any other account.
 
-As a member of an organization, you are assigned an [API token]({{@link tutorials/integrations.md#api-token}}) (under the **Integrations** tab) and proxy password (click the **Proxy** button in the left menu) for accessing the Apify platform via REST API.
+As a member of an organization, you are assigned an [API token]({{@link integrations.md#api-token}}) (under the **Integrations** tab) and proxy password (click the **Proxy** button in the left menu) for accessing the Apify platform via REST API.
 
 ![Integration tokens]({{@asset access_rights/images/integrations.webp}})
 

content/docs/actors.md

@@ -13,7 +13,7 @@ paths:
 
 Actors are serverless cloud programs that can do almost anything a human can do in a web browser. They can do anything from small tasks like filling in forms or unsubscribing from online services, all the way up to scraping and processing vast numbers of web pages.
 
-You can use actors [manually in the Apify Console](https://console.apify.com/actors), using [API](/api/v2) or [scheduler]({{@link schedules.md}}). You can easily [integrate them with other apps]({{@link tutorials/integrations.md}}) and share your actors with other Apify users via our [access rights]({{@link access_rights.md}}) system.
+You can use actors [manually in the Apify Console](https://console.apify.com/actors), using [API](/api/v2) or [scheduler]({{@link schedules.md}}). You can easily [integrate them with other apps]({{@link integrations.md}}) and share your actors with other Apify users via our [access rights]({{@link access_rights.md}}) system.
 
 > New to Apify? [Try actors with our **quick start** tutorial]({{@link tutorials/quick_start.md}}).
 

content/docs/tutorials/integrations.md renamed to content/docs/integrations.md

@@ -1,47 +1,57 @@
 ---
 title: Integrations
 description: Learn how to connect the Apify platform with your projects. You can use our tools in cloud services like Zapier, Make (formerly Integromat), Keboola, and many more.
-menuWeight: 3.4
+menuWeight: 11
+category: platform
 paths:
+    - integrations
     - tutorials/integrations
 ---
 
 # Integrations
 
 You can connect Apify with practically any cloud service or web app. They allow you to pass your [actor]({{@link actors.md}}) run results to other services, process them, and receive notifications on important events.
 
-## [](#what-is-software-integration) What is software integration?
+## What is software integration?
 
 Integration allows you to combine separate applications and take advantage of their combined capabilities. It allows you to combine the abilities of applications that are not directly linked. This helps to free your data from isolation and make it more productive.
 
-## [](#how-does-integration-work) How does integration work?
+## How does integration work?
 
-Integrations use [APIs](https://www.smashingmagazine.com/2018/01/understanding-using-rest-api/) and [webhooks]({{@link webhooks.md}}) to transfer data between applications.
+Integrations use [APIs](https://www.smashingmagazine.com/2018/01/understanding-using-rest-api/) and [webhooks]({{@link integrations/webhooks.md}}) to transfer data between applications.
 Our [RESTful API](/api/v2#) allows you to control the Apify platform from any application.
 You can create [actors](/api/v2#/reference/actors/actor-collection/create-actor) and [tasks](/api/v2#/reference/actor-tasks/task-collection/create-task),
 [start and stop your runs](/api/v2#/reference/actor-tasks/run-task-synchronously/run-task-synchronously-(post)),
 and [manage your data](/api/v2#/reference/datasets/item-collection/put-items) using only HTTP requests (or our handy API clients [for JavaScript]({{@link apify_client_js.md}}) and [for Python]({{@link apify_client_python.md}})).
-Meanwhile, webhooks allow you to perform tasks like sending HTTP requests or notifications when certain [events]({{@link webhooks/events.md}}) occur.
+Meanwhile, webhooks allow you to perform tasks like sending HTTP requests or notifications when certain [events]({{@link integrations/webhooks/events.md}}) occur.
 
-## [](#get-started) Get started
+## Get started
 
 Below are some examples of the kind of integrations you can set up with Apify.
 
+Services you can connect to to extend the functionality of your actors:
+
+- [Slack](https://help.apify.com/en/articles/6454058-apify-integration-for-slack).
+
+- [Webhooks]({{@link integrations/webhooks.md}}).
+
+Other platforms you can connect to Apify:
+
 - [Zapier](https://zapier.com/apps/apify/integrations). See the [tutorial](https://help.apify.com/en/articles/3034235-getting-started-with-apify-integration-for-zapier).
 
-- [Google](https://google.com). See the [tutorial](https://help.apify.com/en/articles/2424053-google-integration).
+- [Google](https://help.apify.com/en/articles/2424053-google-integration).
 
 - [Keboola](https://components.keboola.com/components/apify.apify). See the [tutorial](https://help.apify.com/en/articles/2003234-keboola-integration).
 
 - [Make](https://www.make.com/en/integrations/apify) (formerly Integromat).
 
 - [Airbyte](https://docs.airbyte.io/integrations/sources/apify-dataset).
 
-## [](#api-token) API token
+## API token
 
-To access our API in your integrations, you will need to use your secret API token. You can find it on the [Integrations](https://console.apify.com/account?tab=integrations) page in the Apify Console.
+To access our API in your integrations, you will need to use your secret API token. You can find it on the [Integrations](https://console.apify.com/account?tab=integrations) page in the Apify Console. Give your token a reasonable description and never use one token for several services, much like you shouldn't use the same password for different accounts.
 
-![Integrations page in the Apify Console]({{@asset tutorials/images/api-token.webp}})
+![Integrations page in the Apify Console]({{@asset integrations/images/api-token.webp}})
 
 > When providing your API authentication token, we recommend using the request's `Authorization` header, rather than the URL. ([More info](#introduction/authentication)).