> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zeotap.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Batch Real Time Destination Integration

## Overview

Batch is a mobile marketing automation platform that enables marketers to engage with their mobile app users through push notifications, in-app messaging and email. Integrated with Zeotap it provides a range of features and capabilities that enable marketers to create personalised and relevant experiences for their users and drive engagement, retention and revenue. Use this real-time integration to send custom audiences to Batch. A custom audience can contain a list of custom user IDs, advertising IDs (GAID or IDFA) or install IDs.

## Prerequisites

Ensure that the following prerequisites are taken care of before proceeding with this integration:

* Ensure that you have a Batch account. After logging into the Batch account you are redirected to the Batch dashboard.
* Ensure that you have integrated or set up your mobile applications with Batch. The already integrated mobile applications appear on the Batch dashboard.

## Components of Batch

To understand the components of Batch, navigate to the Batch Dashboard and click SETTINGS from the top panel as shown below.

<Frame>
  <img src="https://mintcdn.com/zeotap/tJTMnKpQ_XdN4jt3/articles/integrate-customer/Storage/integrate-customer/batch-real-time-destination-integration/batch-real-time-destination-integration-2024-07-06.png?fit=max&auto=format&n=tJTMnKpQ_XdN4jt3&q=85&s=9a879ce27cac4652911d6d1bf57945b1" width="2844" height="1202" data-path="articles/integrate-customer/Storage/integrate-customer/batch-real-time-destination-integration/batch-real-time-destination-integration-2024-07-06.png" />
</Frame>

The **General tab** of the **SETTINGS** page displays the API keys. Copy the **Live API Key** and **REST API Key** and use them while creating the destination.

<Frame>
  <img src="https://mintcdn.com/zeotap/puXmsvA7x0OblYvo/articles/integrate-customer/Storage/integrate-customer/project-destination-internal/Imported/batch-img0002.png?fit=max&auto=format&n=puXmsvA7x0OblYvo&q=85&s=0ce46ca2912851addb44380937cf59fe" width="2172" height="716" data-path="articles/integrate-customer/Storage/integrate-customer/project-destination-internal/Imported/batch-img0002.png" />
</Frame>

## Destination Setup

After you have applied filters or added conditions for your users in Journeys, you can activate them in Batch under **Send to Destinations.** A new window appears, where you can set up your destination. You can use an already existing destination from the list of available Destinations or create a new one by clicking **+ Add New Destination**.

<Frame>
  <img src="https://mintcdn.com/zeotap/tJTMnKpQ_XdN4jt3/articles/integrate-customer/Storage/integrate-customer/batch-real-time-destination-integration/batch-real-time-destination-integration-2024-08-07.png?fit=max&auto=format&n=tJTMnKpQ_XdN4jt3&q=85&s=3335835d8f205160ee30dc1c35934c60" width="1858" height="1070" data-path="articles/integrate-customer/Storage/integrate-customer/batch-real-time-destination-integration/batch-real-time-destination-integration-2024-08-07.png" />
</Frame>

### Add New Destination

Perform the following steps to add a new destination:

<Steps>
  <Step>
    Click **Add New Destination.**
  </Step>

  <Step>
    Search for **Batch.**
  </Step>

  <Step>
    Click **Batch** and enter a name for the Destination.
  </Step>

  <Step>
    Add the **Live API Key** and **Rest API Key** that you obtained from Batch and click **Next**. [Learn more](/articles/integrate-customer/batch-real-time-destination-integration#h1__1215361119)

    <Frame>
      <img src="https://mintcdn.com/zeotap/tJTMnKpQ_XdN4jt3/articles/integrate-customer/Storage/integrate-customer/batch-real-time-destination-integration/batch-real-time-destination-integration-2024-08-07-6.png?fit=max&auto=format&n=tJTMnKpQ_XdN4jt3&q=85&s=d24a145941d55630c3101bab2d547908" width="1034" height="1024" data-path="articles/integrate-customer/Storage/integrate-customer/batch-real-time-destination-integration/batch-real-time-destination-integration-2024-08-07-6.png" />
    </Frame>
  </Step>

  <Step>
    In the mapping screen that appears, under **Choose your Action**, select **Batch Symphony** as the action for sending data from the workflow created in Journeys. Under **Map the Fields**, map the Catalogue fields to relevant Destination fields as per your requirement.

    <Note>
      **Note:**

      When mapping fields in event attributes, make sure you use lower case. The values allowed here are a-z0-9\_
    </Note>

    <Frame>
      <img src="https://mintcdn.com/zeotap/tJTMnKpQ_XdN4jt3/articles/integrate-customer/Storage/integrate-customer/batch-real-time-destination-integration/batch-real-time-destination-integration-2024-08-07-7.png?fit=max&auto=format&n=tJTMnKpQ_XdN4jt3&q=85&s=b26c2a890eead7d25efb4ff199d4a28b" width="1668" height="1594" data-path="articles/integrate-customer/Storage/integrate-customer/batch-real-time-destination-integration/batch-real-time-destination-integration-2024-08-07-7.png" />
    </Frame>
  </Step>

  <Step>
    Once the mapping is complete, click **Create Destination**. The destination is created and made available for activation on Journeys.
  </Step>
</Steps>

## Activate the Destination on Journeys

After creating a destination, next, you need to link it in the **Send to Destination** node within the workflow, as explained below.

<Steps>
  <Step>
    In the workflow, click **+** and choose **Send to Destinations**.

    <Frame>
      <img src="https://mintcdn.com/zeotap/tJTMnKpQ_XdN4jt3/articles/integrate-customer/Storage/integrate-customer/batch-real-time-destination-integration/batch-real-time-destination-integration-2024-08-07-3.png?fit=max&auto=format&n=tJTMnKpQ_XdN4jt3&q=85&s=747854bf36e7de769d121ce2a41af6f3" width="1032" height="542" data-path="articles/integrate-customer/Storage/integrate-customer/batch-real-time-destination-integration/batch-real-time-destination-integration-2024-08-07-3.png" />
    </Frame>
  </Step>

  <Step>
    Choose the destination from the list of available destinations by using the search feature.
  </Step>

  <Step>
    Under the **Destination Details** tab, the **Live API Key** and **Rest API Keys** fields are automatically populated based on the value that you had entered while creating the destination. However, under the **Audiences** field, you need to enter a name to categorise your users.

    <Frame>
      <img src="https://mintcdn.com/zeotap/tJTMnKpQ_XdN4jt3/articles/integrate-customer/Storage/integrate-customer/batch-real-time-destination-integration/batch-real-time-destination-integration-2024-08-07-9.png?fit=max&auto=format&n=tJTMnKpQ_XdN4jt3&q=85&s=3f313401e1d63cb050deb259f0219a8c" width="1906" height="1072" data-path="articles/integrate-customer/Storage/integrate-customer/batch-real-time-destination-integration/batch-real-time-destination-integration-2024-08-07-9.png" />
    </Frame>
  </Step>

  <Step>
    Under the **Destination Settings** tab, choose the Action and mapping as per your requirement.

    <Frame>
      <img src="https://mintcdn.com/zeotap/tJTMnKpQ_XdN4jt3/articles/integrate-customer/Storage/integrate-customer/batch-real-time-destination-integration/batch-real-time-destination-integration-2024-08-07-8.png?fit=max&auto=format&n=tJTMnKpQ_XdN4jt3&q=85&s=aa225866f4b135dc3a3498a8250dddb5" width="1914" height="1770" data-path="articles/integrate-customer/Storage/integrate-customer/batch-real-time-destination-integration/batch-real-time-destination-integration-2024-08-07-8.png" />
    </Frame>
  </Step>

  <Step>
    Upon clicking **Save Destination**. The destination is attached as shown in the image below.

    <Frame>
      <img src="https://mintcdn.com/zeotap/tJTMnKpQ_XdN4jt3/articles/integrate-customer/Storage/integrate-customer/batch-real-time-destination-integration/batch-real-time-destination-integration-2024-08-07-10.png?fit=max&auto=format&n=tJTMnKpQ_XdN4jt3&q=85&s=d44072f963180d0e6e7c534158a1125b" width="1884" height="1102" data-path="articles/integrate-customer/Storage/integrate-customer/batch-real-time-destination-integration/batch-real-time-destination-integration-2024-08-07-10.png" />
    </Frame>
  </Step>
</Steps>

## View Events Sent on Batch Dashboard

In the Batch dashboard, you can find all the User Traits, Events and other attributes shared from Zeotap to Batch under **Settings** > **Custom data**.

<Frame>
  <img src="https://mintcdn.com/zeotap/tJTMnKpQ_XdN4jt3/articles/integrate-customer/Storage/integrate-customer/batch-integration/batch-integration-2024-01-22-4.png?fit=max&auto=format&n=tJTMnKpQ_XdN4jt3&q=85&s=727d9abfc69e6ef42f8bc1c64f369886" width="1090" height="144" data-path="articles/integrate-customer/Storage/integrate-customer/batch-integration/batch-integration-2024-01-22-4.png" />
</Frame>

Ensure that you enable these events and attributes to view them on the **Userbase**, where you can create automations. To do so, click the toggle button against the attribute and click **save** when prompted. Note that by hovering the cursor on the **Properties** of the attributes, you can view all the event details that are sent along.

<Frame>
  <img src="https://mintcdn.com/zeotap/tJTMnKpQ_XdN4jt3/articles/integrate-customer/Storage/integrate-customer/batch-integration/batch-integration-2024-01-22-5.png?fit=max&auto=format&n=tJTMnKpQ_XdN4jt3&q=85&s=fbdab4f1cf61981d292db8911d400363" width="1282" height="498" data-path="articles/integrate-customer/Storage/integrate-customer/batch-integration/batch-integration-2024-01-22-5.png" />
</Frame>

## Create Push Trigger Automation in Batch

To create a push trigger automation in Batch, perform the following steps:

<Steps>
  <Step>
    In the Batch dashboard, go to **Automations** and click **New Automation.**
  </Step>

  <Step>
    Choose either **Push notification** or **I** **n-app message** as per your requirement.

    <Frame>
      <img src="https://mintcdn.com/zeotap/tJTMnKpQ_XdN4jt3/articles/integrate-customer/Storage/integrate-customer/batch-real-time-destination-integration/batch-real-time-destination-integration-2024-07-06-1.png?fit=max&auto=format&n=tJTMnKpQ_XdN4jt3&q=85&s=467523fe1c86fb558d14ba7595e5a012" width="3068" height="1026" data-path="articles/integrate-customer/Storage/integrate-customer/batch-real-time-destination-integration/batch-real-time-destination-integration-2024-07-06-1.png" />
    </Frame>
  </Step>

  <Step>
    Based on the campaign type you choose, enter the required details as mentioned in the following steps:

    a. Enter a descriptive name for the automation.

    b. Under Custom Audiences, choose the desired audiences using the drop-down menu. This is an optional step.

    <Frame>
      <img src="https://mintcdn.com/zeotap/tJTMnKpQ_XdN4jt3/articles/integrate-customer/Storage/integrate-customer/batch-real-time-destination-integration/batch-real-time-destination-integration-2024-07-06-2.png?fit=max&auto=format&n=tJTMnKpQ_XdN4jt3&q=85&s=bc73c5af187ca78ed8c1ceff0ee944af" width="3058" height="1794" data-path="articles/integrate-customer/Storage/integrate-customer/batch-real-time-destination-integration/batch-real-time-destination-integration-2024-07-06-2.png" />
    </Frame>

    c. Choose the event following which, the notification must be sent.

    <Frame>
      <img src="https://mintcdn.com/zeotap/tJTMnKpQ_XdN4jt3/articles/integrate-customer/Storage/integrate-customer/batch-integration/batch-integration-2024-01-22-8.png?fit=max&auto=format&n=tJTMnKpQ_XdN4jt3&q=85&s=4d513cff4b7f50966d8f1a9f70c6d783" width="1294" height="540" data-path="articles/integrate-customer/Storage/integrate-customer/batch-integration/batch-integration-2024-01-22-8.png" />
    </Frame>

    d. Enter the message to be shared with the customers in the notification, once the event is triggered.
  </Step>

  <Step>
    Click **Save and run** to start the automation. You can tailor the automation configurations according to your specific requirements.

    <Note>
      **Note:**

      Below are some important links from Batch documentation.

      * To learn more about how to create a push trigger automation in Batch, click [here](https://help.batch.com/en/articles/8304310-how-to-create-a-push-trigger-automation).
      * To learn more about how to create your first email trigger automation in Batch, click [here](https://help.batch.com/en/articles/8281909-how-to-create-your-first-email-trigger-automation-on-the-dashboard).
    </Note>
  </Step>
</Steps>
