> For the complete documentation index, see [llms.txt](https://docs.wonderchat.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.wonderchat.io/integration-guides/slack/slack-via-zapier.md).

# Slack (via Zapier)

Guide on How to Integrate Wonderchat with Slack via Zapier.

By integrating Wonderchat with Slack, it allows your team members to chat with your Wonderbot.

**Required tools:**

* Zapier
* A Slack account
* A dedicated channel for conversations with your Wonderchat bot

**View our Slack template here:**

{% embed url="<https://zapier.com/shared/wonderchat-on-slack-integration/ffb9807106dc7ead3a488df59d333cc6b2f5fd5b>" %}

***

## Overview of our Slack Integration Template

The Slack Integration Template consists of three key steps to follow:

<figure><img src="https://3760420285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0WUvfmkdMPXz3x7NXP8i%2Fuploads%2Fgit-blob-1d6834f3d01942f9f47c2ca791c6c6d9f35816ed%2Fimage.png?alt=media" alt="" width="563"><figcaption><p>Steps for Slack Integration</p></figcaption></figure>

***

## Setting Up in Slack

### Step 1: Open Wonderchat's Slack Template on Zapier

1. To set up your Wonderchat Bot on Zapier, you would need to open our ↗ [Slack Integration Template](https://zapier.com/shared/wonderchat-on-slack-integration/ffb9807106dc7ead3a488df59d333cc6b2f5fd5b)
2. Sign in with your Slack account to create your first event.

### Step 2: Choose Trigger Event for Slack

We recommend selecting '**New Message Posted to Channel**' as the trigger event for messages in your chosen Slack channel.

<figure><img src="https://3760420285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0WUvfmkdMPXz3x7NXP8i%2Fuploads%2Fgit-blob-1a2e769d8ded3c951d28ac67261982cf61c154d2%2Fimage.png?alt=media" alt="" width="563"><figcaption><p>Select <strong>"New Message Posted to Channel"</strong></p></figcaption></figure>

### Step 3: Sign in to Slack to continue

<figure><img src="https://3760420285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0WUvfmkdMPXz3x7NXP8i%2Fuploads%2Fgit-blob-0c470e10984210cc6298d298959680e59b87babc%2Fimage.png?alt=media" alt=""><figcaption><p>Sign in and Connect Slack</p></figcaption></figure>

### Step 4: Select the Slack Channel for Hosting Your Wonderchat Bot

In this example, we have selected our channel as "Wonderchat-Zapier"

<figure><img src="https://3760420285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0WUvfmkdMPXz3x7NXP8i%2Fuploads%2Fgit-blob-74d7ac5f9658bfb1642280c3579b45e730a3e013%2Fimage.png?alt=media" alt=""><figcaption><p>Choose your channel</p></figcaption></figure>

### Step 5: Test the Trigger

<figure><img src="https://3760420285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0WUvfmkdMPXz3x7NXP8i%2Fuploads%2Fgit-blob-4c6383c93f1f6b4865a55f3840128266ef57bc9c%2Fimage.png?alt=media" alt=""><figcaption><p>Click "Test Trigger"</p></figcaption></figure>

***

## Asking Questions in Wonderchat

### Step 1: Under App & Event, select 'Wonderchat'

<figure><img src="https://3760420285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0WUvfmkdMPXz3x7NXP8i%2Fuploads%2Fgit-blob-bbb70817b5b2bee66117e45ddf224274ef5f0b6c%2Fimage.png?alt=media" alt=""><figcaption><p>Select <strong>'Wonderchat'</strong> as app</p></figcaption></figure>

### Step 2: Under Action event, select 'Ask Question'

<figure><img src="https://3760420285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0WUvfmkdMPXz3x7NXP8i%2Fuploads%2Fgit-blob-b11776dc12f80d81d02cc193c544bbea20a9cdfa%2Fimage.png?alt=media" alt=""><figcaption><p>Select <strong>"Ask Question"</strong></p></figcaption></figure>

### Step 3: In a separate tab, retrieve your API Keys from ↗ [Wonderchat](https://app.wonderchat.io/)

#### How to Retrieve API Keys from Wonderchat

* From the left-panel on the Wonderchat App, go to **Settings** > **API Keys** > **"Generate API Key"**
* Click the 'Show' icon, and copy the API Key generated

<figure><img src="https://3760420285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0WUvfmkdMPXz3x7NXP8i%2Fuploads%2Fgit-blob-45de3ae4e0176b14e32431061972815e5e0e06f9%2Fimage.png?alt=media" alt=""><figcaption><p>Copy the API Key generated</p></figcaption></figure>

### Step 4: Go back to Zapier app, sign in under 'Account'

<figure><img src="https://3760420285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0WUvfmkdMPXz3x7NXP8i%2Fuploads%2Fgit-blob-8ef723def32195b69baf16d58844197ac8543a5f%2Fimage.png?alt=media" alt=""><figcaption><p>Click 'Sign in'</p></figcaption></figure>

### Step 5: In the sign in pop-up window, paste your API Key

<figure><img src="https://3760420285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0WUvfmkdMPXz3x7NXP8i%2Fuploads%2Fgit-blob-9bf37b1329cb0e0f540bc7149afa61c23f1010e4%2Fimage.png?alt=media" alt=""><figcaption><p>Paste the API Key and continue</p></figcaption></figure>

<figure><img src="https://3760420285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0WUvfmkdMPXz3x7NXP8i%2Fuploads%2Fgit-blob-ad09ee9adabd57fd52f2470ad9c009b1723fd64b%2Fimage.png?alt=media" alt=""><figcaption><p>Click continue</p></figcaption></figure>

### Step 6: Under Questions, select 'Text' option

<figure><img src="https://3760420285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0WUvfmkdMPXz3x7NXP8i%2Fuploads%2Fgit-blob-e508627b5ee756ba79cd44b6e4a469e4e37b26ab%2Fimage.png?alt=media" alt=""><figcaption><p>Choose 'text'</p></figcaption></figure>

### Step 7: In the separate tab, retrieve your Wonderchat's Chatbot ID

#### How to retrieve Chatbot ID

* Go to **Dashboard** > **Actions (⋮)** > "**View Chatbot"**
* Your Chatbot ID can be found at the end of your chatbot URL

{% hint style="info" %}
For example, your chatbot url is: [https://app.wonderchat.io/chatbot/**cm0w2lbcf0fyienmkv56pepde**](https://app.wonderchat.io/chatbot/cm0w2lbcf0fyienmkv56prpce)

Your Chatbot ID is therefore:

"[<mark style="background-color:orange;">**cm0w2lbcf0fyienmkv56pepde**</mark>](https://app.wonderchat.io/chatbot/cm0w2lbcf0fyienmkv56prpce)**"**
{% endhint %}

### Step 8: Paste your Chatbot ID

<figure><img src="https://3760420285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0WUvfmkdMPXz3x7NXP8i%2Fuploads%2Fgit-blob-95041b5cbdb5530f1f674cd09f9c298f701f4455%2Fimage.png?alt=media" alt=""><figcaption><p>Click continue</p></figcaption></figure>

### Step 9: Leave 'Chatlog ID' field blank. Press 'Continue'.

<figure><img src="https://3760420285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0WUvfmkdMPXz3x7NXP8i%2Fuploads%2Fgit-blob-d09f3efd0f5334cb6b4d9f4a555518d2fd525c1c%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

### Step 10: Test the Action to Ensure It Works in Your Slack Channel

<figure><img src="https://3760420285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0WUvfmkdMPXz3x7NXP8i%2Fuploads%2Fgit-blob-5c1a43c1d76a0fa5cb076e5fef3505c5c6baca3c%2Fimage.png?alt=media" alt=""><figcaption><p>Click '<strong>Test step</strong>'</p></figcaption></figure>

<figure><img src="https://3760420285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0WUvfmkdMPXz3x7NXP8i%2Fuploads%2Fgit-blob-b336b85d1a49e2b2475c295b573f01346ad91672%2Fimage.png?alt=media" alt=""><figcaption><p>Click <strong>'Continue'</strong></p></figcaption></figure>

***

## Sending Channel Message in Slack

### Step 1: Select 'Slack' as app

<figure><img src="https://3760420285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0WUvfmkdMPXz3x7NXP8i%2Fuploads%2Fgit-blob-6dd111bd66d13c8106e18a10f98d493a95fc53bc%2Fimage.png?alt=media" alt=""><figcaption><p>Choose 'Slack' as app</p></figcaption></figure>

### Step 2: Under Event, select "Send Channel Message"

<figure><img src="https://3760420285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0WUvfmkdMPXz3x7NXP8i%2Fuploads%2Fgit-blob-8c2453539e660bebebdeac040c55aa28df21fcda%2Fimage.png?alt=media" alt=""><figcaption><p>Select <strong>'Send Channel Message</strong>'</p></figcaption></figure>

<figure><img src="https://3760420285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0WUvfmkdMPXz3x7NXP8i%2Fuploads%2Fgit-blob-b62ca8c0a1fba56b86ee9736627abcebf82f743e%2Fimage.png?alt=media" alt=""><figcaption><p>Description for 'Send Channel Message'</p></figcaption></figure>

### Step 3: Select your Slack account

{% hint style="info" %}
Ensure the account connected is the same one used to create the channel.
{% endhint %}

<figure><img src="https://3760420285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0WUvfmkdMPXz3x7NXP8i%2Fuploads%2Fgit-blob-da09d1f118c31753f0bf05776881843799f1858c%2Fimage.png?alt=media" alt=""><figcaption><p>Connect Slack account and continue</p></figcaption></figure>

### Step 4: Configure Settings

#### Channel

* Please selected as the name of channel you wish for your bot to reside in

<figure><img src="https://3760420285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0WUvfmkdMPXz3x7NXP8i%2Fuploads%2Fgit-blob-db88ed72a9c6e119a3473e5b7a8153656ff05903%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

#### Message Text

* Under **'Ask Questions from Wonderchat'** dropdown, choose **'Response'**

<figure><img src="https://3760420285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0WUvfmkdMPXz3x7NXP8i%2Fuploads%2Fgit-blob-dd9cb48e58fb611b81cb34dc9f4e7ae0c9042cf8%2Fimage.png?alt=media" alt=""><figcaption><p>Click on '+' > Under '2. Ask Question' > Select 'Response'</p></figcaption></figure>

#### Send as a bot

* Please select '**YES**' for this option.

<figure><img src="https://3760420285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0WUvfmkdMPXz3x7NXP8i%2Fuploads%2Fgit-blob-578bbd9cfeeba00eaeefc9e9b3ca11e0f9e272e5%2Fimage.png?alt=media" alt=""><figcaption><p>Select 'Yes'</p></figcaption></figure>

#### Bot Name

* Enter name of your chatbot, e.g. 'Wonderchat'

<figure><img src="https://3760420285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0WUvfmkdMPXz3x7NXP8i%2Fuploads%2Fgit-blob-01d9c3de8978e411a0d38b586e775f9e746d86fa%2Fimage.png?alt=media" alt=""><figcaption><p>Enter name of your chatbot</p></figcaption></figure>

#### Bot Icon

* Share a link to the profile picture of your chatbot, e.g. from Google Drive

<figure><img src="https://3760420285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0WUvfmkdMPXz3x7NXP8i%2Fuploads%2Fgit-blob-01bbe35df51bdea2175f1745144b31052e8566df%2Fimage.png?alt=media" alt=""><figcaption><p>Enter the link of your picture</p></figcaption></figure>

#### Include a Link to your Zap

* Please select '**NO'** for this option
* Recommended to turn off to prevent link crowding

<figure><img src="https://3760420285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0WUvfmkdMPXz3x7NXP8i%2Fuploads%2Fgit-blob-b700f74895e88614eef3729d5ab17b3c444f3df5%2Fimage.png?alt=media" alt=""><figcaption><p>Select 'No' (Recommended Setting)</p></figcaption></figure>

#### Attach Image by URL

* Please leave this field blank

<figure><img src="https://3760420285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0WUvfmkdMPXz3x7NXP8i%2Fuploads%2Fgit-blob-2a82f35a5f2d7d7e5a28ef202d62664c96b09ca9%2Fimage.png?alt=media" alt=""><figcaption><p>Leave this field blank</p></figcaption></figure>

#### Auto-Expand Links

* Please select '**NO'** for this option
* Recommended to turn off, unless you would like to show links as thumbnails

<figure><img src="https://3760420285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0WUvfmkdMPXz3x7NXP8i%2Fuploads%2Fgit-blob-7774388c04504edce0be52eaab587dfa4906b7b4%2Fimage.png?alt=media" alt=""><figcaption><p>Select 'No' (Recommended Setting)</p></figcaption></figure>

#### Link Usernames and Channel Names

* Please select '**YES**' for this option

<figure><img src="https://3760420285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0WUvfmkdMPXz3x7NXP8i%2Fuploads%2Fgit-blob-8d5c2d3cb8298d397904d9b55ac72c7c2cdafb92%2Fimage.png?alt=media" alt=""><figcaption><p>Select 'Yes'</p></figcaption></figure>

#### Schedule At / File / Thread / Send Channel Message

* These fields are **optional**, and don’t need to be filled in unless you want to customize them for your specific needs.
* We’re offering a recommended setup for using Wonderchat on Slack, but you’re free to modify it as you see fit.

### Step 5: Test your Zap

You can select 'Test Step' to see how your configurations would turn out.

<figure><img src="https://3760420285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0WUvfmkdMPXz3x7NXP8i%2Fuploads%2Fgit-blob-101e82b2320ddf1e905cc768b51b4a711193486d%2Fimage.png?alt=media" alt=""><figcaption><p>Click 'Test step' to try out configurations</p></figcaption></figure>

<figure><img src="https://3760420285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0WUvfmkdMPXz3x7NXP8i%2Fuploads%2Fgit-blob-611626a11f81462a9f6c4dda686afae78a215202%2Fimage.png?alt=media" alt=""><figcaption><p>Sample of Channel Message Sent</p></figcaption></figure>

<figure><img src="https://3760420285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0WUvfmkdMPXz3x7NXP8i%2Fuploads%2Fgit-blob-119a913b45ca43e52999749b47df47583b0ef7c9%2Fimage.png?alt=media" alt=""><figcaption><p>Sample of chatbot reply</p></figcaption></figure>

### Step 6: Publish your Zap

<figure><img src="https://3760420285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0WUvfmkdMPXz3x7NXP8i%2Fuploads%2Fgit-blob-87cb0fbb6e06493cea9a8e26cef71abf242e856f%2Fimage.png?alt=media" alt=""><figcaption><p>Click 'Publish'</p></figcaption></figure>

You’re all ready to go, hit “publish” to set-up your Zap! You’re now ready to use your Wonderchat bot on Slack.

***

If you have any more questions, feel free to reach out to us at <mark style="color:purple;">**<support@wonderchat.io>**</mark>
