Platform Integrations

Your chatbot becomes useful when your customers can actually reach it. This guide walks you through connecting your chatbot to the channels where your customers already spend their time — no developer experience required.

Overview

Connect your chatbot to one or more channels at the same time. Supported channels include Website widget, Telegram, Zalo, Zalo OA, Facebook Messenger, and Custom API. All platform settings live inside your chatbot under the Platforms tab, and which channels are available depends on your subscription plan.

Platform Availability by Plan

Website Widget

The website widget adds a small chat button to your website. When a visitor clicks it, a chat window opens — no login or download required on their end.

Setting Up

1. Open your chatbot and click the Platforms tab.
2. Click Add Platform and select Web.
3. The platform is created automatically — you will see an embed code snippet.
4. Copy the embed code and paste it into your website's HTML, just before the closing </body> tag.

Embed Code Example

htmlCopy
<script
  src="https://your-platform-domain.com/embed/chatbot.js"
  data-chatbot-id="your-chatbot-id"
  defer
></script>

Paste this once into your website template and the widget will appear on every page automatically.

Customizing the Widget

• Color — set your brand color at Settings → Basic Info → Color
• Avatar — upload a square image (your logo or an illustration) to appear on the chat button and in the conversation header
• Status — your chatbot must be set to Public for website visitors to use it; keep it Private while you are still testing

Tip: Open a private or incognito browser window and visit your website to see exactly what a first-time visitor sees before you go live.

How Visitors Are Tracked

Each visitor is automatically assigned a unique anonymous ID when they start a conversation. Their conversation history is saved and linked to a customer profile. If CRM is enabled, you can view their full history from the Conversations page.

Telegram

Connect your chatbot to a Telegram bot so users can chat with it directly inside the Telegram app — on mobile or desktop.

What You Need Before Starting

• A Telegram account (free at telegram.org)
• A Telegram bot, which you create for free using @BotFather inside Telegram

Setup Steps

1. Open Telegram and search for @BotFather.
2. Send the message /newbot and follow the prompts — you will choose a name and username for your bot.
3. BotFather will give you a Bot Token that looks like 123456789:ABCdef-GHIjkl... — copy it.
4. Go to your chatbot → Platforms → Add Platform → Telegram.
5. Paste the bot token into the field and click Save.
6. The platform registers your webhook automatically — your Telegram bot is now live.

Testing

• In Telegram, search for your bot by the username you chose.
• Send any message — you should receive a reply within a few seconds.

Note: Telegram delivers messages over HTTPS webhooks. This works automatically when using the hosted platform — no server configuration needed on your end.

Tip: In @BotFather, use the /setdescription and /setuserpic commands to add a profile picture and description to your bot. It makes a big difference in how professional it looks to users.

Zalo

Connect your chatbot to a Zalo Official Account (OA) to reach Vietnamese customers through Zalo — one of Vietnam's most widely used messaging apps.

What You Need Before Starting

• A Zalo Official Account — apply and get verified at developers.zalo.me
• A Bot Token and Secret Token from your Zalo Developer Dashboard

Note: Zalo Official Accounts require approval from Zalo. Make sure your OA is verified and active before attempting to connect.

Setup Steps

1. Go to your chatbot → Platforms → Add Platform → Zalo.
2. Enter your Bot Token and Secret Token from the Zalo Developer Dashboard.
3. Click Save.
4. Click the Set Webhook button — this registers your chatbot as the message handler for your OA automatically.
5. In your Zalo Developer Dashboard, confirm that the webhook URL is active and the OA is set to use the chatbot.

Testing

• Send a message to your Zalo OA from a Zalo account.
• You should receive an automated reply from your chatbot within seconds.

Tip: If messages stop coming through after a token refresh in Zalo, go back to Platforms, update the tokens, save, and click Set Webhook again.

Zalo OA (Official Account — App on Behalf)

Connect your chatbot to a Zalo Official Account using the app on behalf integration. This is the recommended approach for Zalo — instead of managing tokens manually, you authorize our app to act on behalf of your OA. Token refresh is handled automatically.

What You Need Before Starting

• A Zalo Official Account — create one at oa.zalo.me
• Your OA must be verified and active

Setup Steps

1. Open your chatbot and click the Platforms tab (or the Chat Flow editor).
2. Find Zalo OA and click Add (the + button).
3. You will be redirected to Zalo's authorization page.
4. Log in to Zalo and select the Official Account you want to connect.
5. Grant the requested permissions (read messages, send messages).
6. You will be redirected back to the chatbot page — the connection is completed automatically.

How It Works

Our app uses OAuth to obtain permission to act on behalf of your OA. Access tokens are refreshed automatically, so there is no manual token management required. Messages from your OA's followers are forwarded to your chatbot via webhook, and your chatbot's replies are sent back through the Zalo OA API.

Differences from the Legacy Zalo Integration

Testing

• Send a message to your Zalo OA from any Zalo account.
• You should receive an automated reply from your chatbot within a few seconds.

Note: If your OA connection stops working, try disconnecting and reconnecting the Zalo OA platform. This will re-authorize the tokens.

Facebook Messenger

Connect your chatbot to a Facebook Page so customers can message it through Facebook Messenger — on web or the Messenger app.

What You Need Before Starting

• A Facebook Page (business pages only — personal profiles are not supported)
• A Facebook Developer App with the Messenger product enabled (create one at developers.facebook.com)
• A Page Access Token from your Facebook Developer App → Messenger settings
• Your Page ID (found in your Page's About section or Page settings)

Setup Steps

1. Go to your chatbot → Platforms → Add Platform → Facebook.
2. Fill in the following fields:
   • Page ID — the numeric ID of your Facebook Page
   • Access Token — copied from your Facebook Developer App → Messenger → Page Access Tokens
   • Verify Token — any string you choose (for example, my-verify-token-2024); you will reuse this in step 4
3. Click Save.
4. In your Facebook Developer App, go to Messenger → Webhooks and enter:
   • Callback URL: https://your-platform-domain.com/api/webhooks/facebook
   • Verify Token: the same string you entered in step 2
5. Subscribe the webhook to messages events.
6. Submit your app for review if required by Facebook (for public pages with many users).

Note: Facebook requires all webhook URLs to use HTTPS. This is handled automatically on the hosted platform.

Tip: Use the Test User feature in your Facebook Developer App → Messenger settings to send test messages before your app goes through Facebook's review process.

Custom API

If you want to embed your chatbot directly into your own app, internal tool, or third-party product, the API platform lets you connect programmatically using a secure token.

Available on: Standard plan and above

Creating an API Token

1. Go to your chatbot → Platforms → Add Platform → API.
2. Enter a descriptive name for the token — for example, Mobile App or Partner Portal.
3. Click Create.
4. The full token is displayed one time only — copy it immediately and store it somewhere safe (a password manager works well).

Warning: Once you leave or refresh the page, the full token cannot be retrieved again. If you lose it, you will need to delete the token and create a new one.

Using the Token

Include the token as a Bearer header in your API requests:

Authorization: Bearer sk_live_your-token-here

For full documentation on available endpoints and request formats, see the API Reference.

Revoking a Token

1. Go to Platforms and find the API entry you want to remove.
2. Click Delete.
3. The token is invalidated immediately — any requests using it will be rejected.

Managing Your Platforms

Viewing All Connected Platforms

The Platforms tab lists every integration you have set up, along with the platform type (Web, Telegram, Zalo, Zalo OA, Facebook, API), a summary of the configuration (for example, the bot username or page name), and the active or inactive status.

Updating a Platform

Click Edit on any platform to update its configuration:

• Telegram — update the bot token if you create a new bot in @BotFather
• Zalo / Facebook — update tokens whenever they expire or are rotated
• Zalo OA — tokens refresh automatically; if issues occur, disconnect and reconnect to re-authorize
• Web — the embed code stays the same unless your chatbot ID changes

Deactivating vs. Deleting

Use Deactivate when you want to temporarily pause a channel. Use Delete only when you are certain you no longer need that integration.

Troubleshooting

If you run into an issue not listed here, reach out to support with the platform type and a description of what you are seeing. We are happy to help you get connected.