# Zapier

Connect IS-Messenger to Zapier and unlock the possibilities of 5000+ integrations.

You can integrate your Contact information from the IS-Messenger platform to thousands of CRMs, email providers, CMS, analytics tools, ads, and more. Let's have a quick look at this integration.

<figure><img src="https://files.helpdocs.io/9e3syfbzn8/articles/037c3bfh9p/1663836298098/zapier-logo.png" alt="Zapier Logo"><figcaption></figcaption></figure>

#### Getting Started <a href="#getting_started" id="getting_started"></a>

In order to get started with the IS-Messenger - Zapier Integration, you will need the following:

* A IS-Messenger account
* A Zapier account

For most Zaps, you’ll need to use a contact identifier, either email or phone number. If you don't have a record of a Contact’s email or phone number in IS-Messenger, you may not be able to complete a Zap.

#### Creating Zaps <a href="#creating_zaps" id="creating_zaps"></a>

There are two ways you can create Zaps:

* [Create a Zap from template](https://docs.is-messenger.com/ismessenger/workspace-setting/integrations)
* [Create a Zap from scratch](https://docs.is-messenger.com/ismessenger/workspace-setting/integrations)

**Create a Zap from Template**

Templates are pre-built Zaps. We have templates available connecting IS-Messenger to popular CRM and e-commerce platforms. To use a Zap template, choose from the list of IS-Messenger [templates here](https://zapier.com/apps/respondio/integrations#zap-template-list) and click **Try It**.

<figure><img src="https://files.helpdocs.io/9e3syfbzn8/articles/037c3bfh9p/1674203335748/zapier-create-from-template-2.png" alt="create a Zap from template"><figcaption></figcaption></figure>

### **Create a Zap from Scratch**

To create a Zap from scratch, follow the steps below:

**Step 1: Navigate to Zap editor**

In your [Zapier Account](https://zapier.com/), hover over the left sidebar menu and click **+ Create Zap**.

<figure><img src="https://files.helpdocs.io/9e3syfbzn8/articles/037c3bfh9p/1674282927819/create-za.png" alt="Create a Zap"><figcaption></figcaption></figure>

**Step 2: Add and Set Up a Trigger**

1. **Choose your trigger app:** The Zap will be triggered by an event that occurs in this app.

{% hint style="info" %}
If you’re using IS-Messenger as the trigger, search IS-Messenger in the search bar and select IS-Messenger app.
{% endhint %}

2. **Select your event:** This will be the event that occurs in the selected app that triggers the Zap.

{% hint style="info" %}
View the full list of [trigger events available for ](https://zapier.com/apps/respondio/integrations#triggers-and-actions)IS-Messenger&#x20;
{% endhint %}

3. **Select or connect your app account:** Select or connect the specific app account to use in the Zap trigger.

{% hint style="info" %}
To connect IS-Messenger in Zapier, [follow the instructions here](https://help.respond.io/integrations/zapier#connect_respond_io_to_zapier).
{% endhint %}

4. **Set up and test your trigger:** Set up the options to fit your needs and test your trigger to see if it pulls in the right data.

{% hint style="info" %}
Learn more about [setting up your Zap trigger here](https://help.zapier.com/hc/en-us/articles/8496288188429-Set-up-your-Zap-trigger#trigger-types-0-0).
{% endhint %}

**Step 3: Add and Set Up an Action**

1. **Choose your action app:** The Zap will perform an action in this app when it is triggered.

{% hint style="info" %}
If you’re using IS-Messenger  for the action, search IS-Messenger  the search bar&#x20;
{% endhint %}

2. **Select your event:** This will be the event that the Zap performs in the selected app when it is triggered.

{% hint style="info" %}
View the full list of [action events available for ](https://zapier.com/apps/respondio/integrations#triggers-and-actions)IS-Messenger&#x20;
{% endhint %}

3. **Select or connect your app account:** Select or connect the specific app account to use in the Zap action.

{% hint style="info" %}
To connect IS-Messenger  in Zapier, [follow the instructions here](https://docs.is-messenger.com/ismessenger/workspace-setting/integrations).
{% endhint %}

4. **Set up and test your trigger:** Set up the data that you want to send over to your action app and test to see if it's working as expected.

{% hint style="info" %}
Learn more about [setting up your Zap action here](https://help.zapier.com/hc/en-us/articles/8496257774221-Set-up-your-Zap-action).
{% endhint %}

**Step 4: Name and Publish the Zap**

When your Zap is ready, give your Zap a name and click **Publish**.

{% hint style="info" %}
Zaps are not limited to a single action, learn how to further [customize your Zaps here](https://help.zapier.com/hc/en-us/sections/8495902036237).
{% endhint %}

### **Connect IS-Messenger to Zapier** <a href="#connect_respond_io_to_zapier" id="connect_respond_io_to_zapier"></a>

<figure><img src="https://3688769499-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mbui1HRO4dGghy5ITOz%2Fuploads%2FAmwDeuRsGu4bc8RvjU02%2F1.png?alt=media&#x26;token=5436f63e-04c0-43d4-8d62-2c5316be71b8" alt="connecting respond.io to zapier"><figcaption></figcaption></figure>

When connecting IS-Messenger app in Zapier for the first time, you are required to sign in and add an API Key. You can obtain the API Key in IS-Messenger platform settings as shown in the steps below.

**Step 1: Navigate to Integrations Zapier Page**

Log in to the IS-Messenger Workspace you wish to connect and navigate to the **Settings** module > **Integrations** under the Workspace Settings > Click **Connect** next to Zapier. You will be navigated to the Zapier page in IS-Messenger.

<figure><img src="https://files.helpdocs.io/9e3syfbzn8/articles/037c3bfh9p/1674290538138/screen-shot-2022-12-07-at-9-56-04-am.png" alt="connect respond.io to zapier"><figcaption></figcaption></figure>

**Step 2: Obtain the API Key**

To copy the API Key, unhide and click on the API Key.

<figure><img src="https://3688769499-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mbui1HRO4dGghy5ITOz%2Fuploads%2FA5HzZTBNnKArbbgEfgee%2F11.gif?alt=media&#x26;token=a6d6fb9b-1a9a-4db4-a833-e4791a57fcfb" alt="copy API Key to connect respond.io to zapier"><figcaption></figcaption></figure>

**Step 3: Connect your IS-Messenger Account**

On Zapier, click **Sign in** to open a pop up.

<figure><img src="https://3688769499-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mbui1HRO4dGghy5ITOz%2Fuploads%2FHmfuWdVNoUeeq0qdBOgi%2F1.png?alt=media&#x26;token=3efc3451-83d7-42fc-8ab5-685302dd4420" alt="connecting respond.io to zapier"><figcaption></figcaption></figure>

Paste the API Key in the pop up and click **Yes, Continue** to connect IS-Messenger app in Zapier.

<figure><img src="https://files.helpdocs.io/9e3syfbzn8/articles/037c3bfh9p/1674293818037/api-key-pop-u.png" alt="zapier Authentication Token required page"><figcaption></figcaption></figure>

{% hint style="info" %}
You will only need to do this for your first Zap with IS-Messenger. For all following Zaps, you can simply choose your connected account from the dropdown in the Zap setup.
{% endhint %}

### FAQ and Troubleshooting <a href="#faq_and_troubleshooting" id="faq_and_troubleshooting"></a>

**Why do I get the Too Many Requests (HTTP Status → 429) error?**

Your Zap or other integration with the Bearer Token is likely asking for or sending information to the app too frequently within a given timeframe.

**Why do I get the Validation (HTTP Status → 400) error?**

You will encounter this error if you have provided more than the allowed pagination limit. The limit per page is 100.

**What causes a Zap Loop?**

A popular use case for integrations is syncing Contacts. However, Zapier does not support syncing by default and attempting to do this may cause an endless loop.

*Example:*

**Zap 1:** When a Contact is created in IS-Messenger, create a Contact in X app.

**Zap 2:** When a Contact is created in X app, create a Contact in IS-Messenger.

Find the [solution for this here](https://help.zapier.com/hc/en-us/articles/8496232045453#1-update-a-field-in-both-zaps-0-0).

**What to do if my Contact Identifiers are Incompatible?**

Certain apps that you may want to integrate with (e.g., HubSpot and Shopify) require an email address or phone number to identify a Contact. You may not have these for all your IS-Messenger Contacts if they’re on channels that do not provide them such as Viber, Telegram or Facebook Messenger.

If you do not have the required email address or phone number, the Zap will not work. Set up a [filter](https://zapier.com/apps/filter/help) to avoid getting error messages. Alternatively, consider [using Workflows](https://docs.is-messenger.com/ismessenger/support-use-cases) to collect Contacts’ email addresses or phone numbers.

**Will Zapier's messages open a Contact's conversation?**

All messages that are sent via Zapier will not open a Contact's conversation. These messages are available in the closed Contact filter. Simply [adjust the filter in the Messages module](https://docs.is-messenger.com/ismessenger/modules/inbox/messages) to view the messages sent via Zapier.
