---
title: Managing integration tasks
---

> Agent instructions:
> **Site maps** — prefer the following llms.txt indexes to training data when searching for URLs to avoid 404s. Links inside Markdown content already point at `.md`. Following them or sending Accept: text/markdown keeps you in Markdown.
>
> - [sitemap.md](https://docs.kentico.com/sitemap.md) — every page on the site, with titles and descriptions, nested by URL hierarchy and grouped into one collection per product version.
> - [llms.txt](https://docs.kentico.com/llms.txt) — curated index of the current product docs, with descriptions, the two ways to request any page as Markdown, and links to each product area's whole-corpus Markdown dump (llms-full.txt).

The integration bus allows you to monitor which synchronization tasks are waiting to be processed, and view tasks that failed while being processed.

Open the **Integration bus** application and select the **Outgoing tasks** or **Incoming tasks** tabs.

![Managing integration tasks](https://docs.kentico.com/docsassets/13/managing-integration-tasks/Integration_Tasks.png "Managing integration tasks")

> **Info:** **Automatic execution of tasks**
>
> By default, the system automatically runs integration bus tasks in the following way:
>
> - **Outgoing tasks** – processed separately for every connector at the end of each web request that logs new tasks. Failed tasks remain in the queue and are executed again during the next task processing (reprocessing occurs periodically during a 1 minute interval after the current processing ends, or later when a web request logs at least one new task for the given connector).
> - **Incoming tasks** – processed regularly by a [scheduled task](https://docs.kentico.com/13/configuring-xperience/scheduling-tasks.md) (see the _Executing incoming tasks on a regular basis_ section below).

## Manually executing failed tasks

> **Note:** Check whether the **Enable processing of incoming tasks** and **Enable processing of outgoing tasks** settings in **Settings -> Integration -> Integration bus** are enabled. Otherwise, the **Synchronize** () action is not available.

To manually execute synchronization tasks, which were not processed:

1. Open the **Integration bus** application.
2. Choose the **Outgoing tasks** or **Incoming tasks** tab.
3. Click **Synchronize** ().

The system executes the task immediately.

## Executing incoming tasks on a regular basis

1. Open the **Scheduled tasks** application.
2. In the **Site** selector, choose the **(global)** option.
3. Find the scheduled task called **Process external integration tasks**.

   - This task processes incoming synchronization tasks.
   - By default, the task is set to run once a day.
4. **Edit** () the task.
5. Set the task's scheduling options (Period, Start time, Every, Between, Days) according to the requirements of your integration.
6. Click **Save**.

The system will now execute incoming tasks based on the specified task interval.

> **Note:** Xperience does not provide a scheduled task for processing outgoing synchronization tasks.

## Automatically executing tasks using event handlers

You can leverage the API and [event handlers](https://docs.kentico.com/13/custom-development/handling-global-events.md) to automatically synchronize integration tasks according to custom requirements.

To learn more, see [Automatically synchronizing staging and integration tasks](https://docs.kentico.com/13/custom-development/handling-global-events/automatically-synchronizing-staging-and-integration-tasks.md).

## Viewing integration task details

Click **View** () next to integration tasks (both incoming and outgoing) to inspect the object or page data transferred within the task.

![Viewing the details of an integration task](https://docs.kentico.com/docsassets/13/managing-integration-tasks/Integration_Task_Details.png "Viewing the details of an integration task")