Docs/Channels

Channels

Connect WhatsApp, Instagram, Messenger, SMS, YouTube, and your web widget to a single shared inbox. Every channel you add is handled by the same AI persona and routed to the same team — no context switching required.

Supported channels

Moxabot supports six inbound message channels. Each is configured separately under Integrations in the sidebar.

Web Widget
Embed a chat bubble on any website
WhatsApp
WhatsApp Business Cloud API via Meta
Instagram / Messenger
Instagram DMs and Messenger via Meta OAuth
SMS via Twilio
Two-way SMS with a Twilio number
SMS via EZ Texting
Two-way SMS through your EZ Texting account
YouTube
Monitor and reply to video comments
Moxabot
Inbox
Contacts
AI Persona
Knowledge
Integrations
Analytics
Team
Billing
Integrations
Connect your channels and tools
Web Widget
● Connected
WhatsApp
● Connected
Instagram
○ Not connected
Messenger
○ Not connected
SMS (Twilio)
○ Not connected
EZ Texting
○ Not connected
YouTube
○ Not connected
⚠️
Warning:Plan limits — Trial accounts cannot connect social channels (WhatsApp, Instagram, YouTube). Starter plans allow up to 2 channels. Growth and above unlock all channels with no cap. SMS via EZ Texting and SMS via Twilio are available on all paid plans (Starter and above). See Billing & Plans for the full comparison.

Web chat widget

The Moxabot widget adds a floating chat bubble to your website. It is a lightweight JavaScript snippet (~142 ms first-load) and works on Shopify, WordPress, Webflow, Framer, plain HTML, and any React/Next.js app. No server-side changes are needed.

Install the script

1
Copy your widget script
In the sidebar go to Integrations → Embed Widget. Click Copy snippet — the script includes your unique widgetKey.
2
Paste before </body>
Add the snippet to every page where the chat should appear. Place it just before the closing </body> tag.
3
Verify it's live
Open your website. The chat bubble appears in the bottom-right corner within a few seconds. Send a test message to confirm it reaches your inbox.
html
<!-- Moxabot web widget — paste before </body> -->
<script>
  window.MoxabotConfig = {
    widgetKey: "YOUR_WIDGET_KEY",
    // Optional customisation:
    accentColor: "#E11D48",       // bubble and header color
    position: "bottom-right",    // "bottom-left" also supported
    greeting: "Hi! How can we help you today?",
    botName: "Aanya"
  };
</script>
<script src="https://cdn.moxabot.com/widget.js" async></script>
app.moxabot.com
Integrations → Embed Widget page showing the script snippet, a copy button, and a live preview of the chat bubble
Integrations → Embed Widget — copy the snippet and preview the bubble before going live

Shopify

1
Open your theme code
In Shopify Admin go to Online Store → Themes, click Actions → Edit code.
2
Edit theme.liquid
In the file tree open Layout / theme.liquid. Paste the Moxabot snippet immediately before </body>.
3
Save and preview
Click Save. Open a Shopify preview — the chat bubble should appear on every storefront page.

WordPress

1
Install a header/footer plugin
Install Insert Headers and Footers (or any equivalent plugin) from the WordPress plugin directory.
2
Paste in the footer section
Go to Settings → Insert Headers and Footers and paste the Moxabot snippet into the Scripts in Footer box.
3
Save changes
Click Save. The widget will appear on all pages including WooCommerce shop and checkout pages.

Webflow

1
Open Project Settings → Custom Code
In the Webflow Designer open Project Settings → Custom Code.
2
Paste in Footer Code
Paste the Moxabot snippet into the Footer Code section.
3
Publish
Click Publish. The widget is live on your Webflow domain (and any connected custom domain).

Customisation options

All customisation is done via the window.MoxabotConfig object before the script tag.

OptionTypeDefaultDescription
widgetKeystring(required)Your unique widget identifier — found in Integrations → Embed Widget.
accentColorstring"#E11D48"Hex color for the chat bubble, header, and send button.
positionstring"bottom-right"Bubble position: "bottom-right" or "bottom-left".
greetingstringAI persona greetingOverride the first message shown to new visitors.
botNamestringAI persona nameOverride the display name shown in the chat header.
offsetXnumber20Horizontal offset from the screen edge in pixels.
offsetYnumber20Vertical offset from the screen edge in pixels.
hideOnMobilebooleanfalseSet to true to suppress the widget on screens narrower than 768 px.
💡
Tip:The widget inherits the greeting message and bot name from your AI Persona settings by default. You only need to set greeting and botName in the config if you want to override per-site.

WhatsApp Business

Moxabot connects to WhatsApp via the WhatsApp Business Cloud API (Meta). You need a verified Meta Business Account and a WhatsApp Business phone number. The API is free for the first 1,000 service conversations per month; Meta charges for additional conversations — this is billed directly by Meta, not Moxabot.

ℹ️
Note:WhatsApp Business Cloud API requires that your Meta Business Account is verified. Business verification typically takes 1–3 business days. Start it at business.facebook.com → Security Center.

What you'll need

CredentialWhere to find it
Phone Number IDMeta Business Manager → WhatsApp → Phone Numbers → select number → info panel
System User Access TokenMeta Business Manager → System Users → generate token with whatsapp_business_messaging and whatsapp_business_management permissions
WhatsApp Business Account IDMeta Business Manager → WhatsApp → Overview (shown next to the account name)

Setup steps

1
Open Meta Business Manager
Go to business.facebook.com and select your business account. If you don't have one, create a free Business Account first.
2
Add a WhatsApp number
Navigate to Business Settings → WhatsApp Accounts → Add. Follow the prompts to add and verify your business phone number via OTP. The number cannot already be registered as a personal WhatsApp account.
3
Create a System User and generate a token
Go to Business Settings → System Users → Add. Create an admin system user, assign it to your WhatsApp Business Account, then click Generate New Token. Select the permissions:
  • whatsapp_business_messaging
  • whatsapp_business_management
Copy and save the token — Meta only shows it once.
4
Enter credentials in Moxabot
In Moxabot go to Integrations → WhatsApp → Connect. Enter your Phone Number ID, Access Token, and WhatsApp Business Account ID, then click Save & Connect.
5
Register the webhook URL
Moxabot displays a Webhook URL and a Verify Token after saving. Go back to Meta Business Manager → WhatsApp → Configuration → Edit Webhook and paste both values. Subscribe to the messages webhook field.
6
Test the connection
Send a WhatsApp message from a personal number to your business number. The message should appear in your Moxabot inbox within a few seconds.
app.moxabot.com
Moxabot Integrations → WhatsApp Connect form showing Phone Number ID, Access Token, and Webhook URL fields
Integrations → WhatsApp — paste your Phone Number ID and Access Token, then copy the Webhook URL back to Meta
⚠️
Warning:Never share your System User Access Token. It grants full messaging access to your WhatsApp number. If compromised, revoke it immediately from Meta Business Manager → System Users and generate a new one.
Moxabot
Inbox
Contacts
AI Persona
Knowledge
Integrations
Analytics
Team
Billing
WhatsApp Business
● Connected — +1 415 555 0100
Active
Phone Number ID
1059284710293847
Access Token
EAAG••••••••••••••••••••
Webhook URL
https://hooks.moxabot.com/wa/abc123

Instagram & Messenger

Connect your Instagram Business account to receive and reply to Instagram Direct Messages, and connect a Facebook Page to handle Messenger conversations — both use the same Meta OAuth flow and appear as separate channel cards in Integrations.

ℹ️
Note:You need an Instagram Business or Creator account linked to a Facebook Page. Personal Instagram accounts are not supported by the Meta Messaging API. To convert, go to Instagram Settings → Account → Switch to Professional Account.

Required page permissions

PermissionWhy it's needed
pages_messagingSend and receive Messenger messages on behalf of the Page
instagram_basicRead the connected Instagram account details
instagram_manage_messagesSend and receive Instagram Direct Messages
pages_read_engagementRead Page conversations and message history
pages_manage_metadataRegister and manage webhook subscriptions for the Page

Setup steps

1
Start the OAuth flow
In Moxabot go to Integrations → Instagram / Messenger → Connect. Click Continue with Facebook. A Meta OAuth popup opens.
2
Select your Facebook Page and Instagram account
In the OAuth dialog, choose the Facebook Page you manage and the linked Instagram Business account. Grant all requested permissions — unselecting any will prevent messages from reaching the inbox.
3
Complete the OAuth flow
Click Done in the Meta dialog, then OK to close the popup. Moxabot exchanges the OAuth code for a long-lived Page Access Token automatically.
4
Verify in Moxabot
Both channel cards (Instagram and Messenger) show a green Connected badge. Send a test DM to your Instagram account from a separate account to confirm it arrives in the inbox.
app.moxabot.com
Meta OAuth permission dialog showing pages_messaging, instagram_manage_messages, and other required permissions selected
The Meta OAuth flow — select your Page and grant all listed permissions to enable two-way messaging
💡
Tip:If you manage multiple Facebook Pages, you can connect each one separately. Each Page appears as its own channel in the inbox with a distinct color tag.

Token refresh

Moxabot automatically refreshes your Page Access Token before it expires (Meta long-lived tokens last 60 days). If you ever revoke Moxabot's access from your Facebook App settings, the channel will show a Disconnected — re-authenticate status and you will need to repeat the OAuth flow.

SMS via Twilio

Twilio gives you a programmable US or international phone number for two-way SMS and MMS conversations. You are billed by Twilio per message segment at their standard rates — Moxabot does not add a per-message surcharge. Twilio SMS is available on all paid Moxabot plans.

What you'll need from Twilio

CredentialWhere to find it
Account SIDTwilio Console → home dashboard — starts with AC…
Auth TokenTwilio Console → home dashboard — click to reveal
Phone NumberTwilio Console → Phone Numbers → Manage → Active Numbers

Setup steps

1
Buy a Twilio number (if you don't have one)
Log in to console.twilio.com. Go to Phone Numbers → Buy a Number. Filter by country and make sure SMS capability is checked. Numbers cost approximately $1.15 / month.
2
Copy your Account SID and Auth Token
On the Twilio Console home page, copy your Account SID and reveal and copy your Auth Token. Keep these secure — they grant full API access to your account.
3
Enter credentials in Moxabot
In Moxabot go to Integrations → SMS (Twilio) → Connect. Enter your Account SID, Auth Token, and the Twilio phone number in E.164 format (e.g. +14155550100). Click Save & Connect.
4
Configure the webhook in Twilio
Moxabot shows a Webhook URL after saving. In the Twilio Console go to Phone Numbers → Manage → Active Numbers, click your number, and under Messaging Configuration → A message comes in set the webhook to the Moxabot URL (method: HTTP POST).
5
Test with a real SMS
Send a text message to your Twilio number from any mobile phone. The message should appear in your Moxabot inbox within seconds. Reply from the inbox to confirm two-way messaging works.
app.moxabot.com
Moxabot Integrations → SMS Twilio form with Account SID, Auth Token, phone number fields, and generated Webhook URL
Integrations → SMS (Twilio) — enter your Twilio credentials, then paste the Webhook URL back into the Twilio Console
💡
Tip:For US 10DLC compliance, register your brand and campaign in the Twilio Console under Messaging → Regulatory Compliance → 10DLC before sending high-volume campaigns. Unregistered numbers may have messages filtered by US carriers.
Moxabot
Inbox
Contacts
AI Persona
Knowledge
Integrations
Analytics
Team
Billing
SMS via Twilio
Two-way SMS with a Twilio number
Account SID
ACc2a3b4d5e6f78901234567890abcdef12
Auth Token
••••••••••••••••••••••••••••••••
Phone Number
+1 415 555 0100
Webhook URL
https://hooks.moxabot.com/twilio/xyz456
Connected and receiving messages

SMS via EZ Texting

If your team already has an EZ Texting account, Moxabot can connect directly using your EZ Texting username and password — no webhook configuration required. Inbound SMS messages are polled and synced to the Moxabot inbox automatically. Replies sent from Moxabot are delivered via your EZ Texting number at your EZ Texting plan rates.

ℹ️
Note:EZ Texting is the simpler of the two SMS integrations — ideal if you already pay for EZ Texting and want to centralise replies in Moxabot without setting up a separate Twilio account.

Setup steps

1
Confirm your EZ Texting plan supports API access
EZ Texting's API is available on their Value plan and above. Log in at eztexting.com and check your plan under Account → Subscription.
2
Enter credentials in Moxabot
In Moxabot go to Integrations → SMS (EZ Texting) → Connect. Enter your EZ Texting username (your login email) and password. Click Save & Connect.
3
Select the number to receive messages on
If your EZ Texting account has multiple phone numbers, select which one Moxabot should monitor from the dropdown that appears after connecting.
4
Test the connection
Send a text to your EZ Texting number. Within 30–60 seconds the message should appear in your Moxabot inbox (EZ Texting uses polling rather than webhooks, so there is a brief delay).
app.moxabot.com
Moxabot Integrations → SMS EZ Texting connect form with username and password fields and a Connect button
Integrations → SMS (EZ Texting) — enter your EZ Texting login credentials to connect
⚠️
Warning:Moxabot stores your EZ Texting password encrypted at rest. We recommend creating a dedicated EZ Texting sub-account or using an API key (available on EZ Texting Enterprise) rather than your primary login. If you update your EZ Texting password, you must reconnect the integration in Moxabot.

EZ Texting vs Twilio — which should I use?

EZ TextingTwilio
Setup complexityLow — username + passwordMedium — SID, token, webhook config
Message latency30–60 sec (polling)Near-instant (webhook)
Number ownershipEZ Texting managedYou own the Twilio number
MMS supportLimitedFull MMS (images, GIFs)
10DLC registrationManaged by EZ TextingYou register in Twilio Console
Best forTeams already on EZ TextingNew SMS setups, high volume

YouTube

Connect your YouTube channel to monitor comments on your videos. The AI can auto-reply to common questions left in comments, and your team can reply manually from the inbox. This is ideal for brands that publish product tutorials, reviews, or live streams with high comment volume.

ℹ️
Note:YouTube comment management uses the YouTube Data API v3 via Google OAuth. Your Google account must be the owner or manager of the YouTube channel you want to connect.

Setup steps

1
Start the OAuth flow
In Moxabot go to Integrations → YouTube → Connect. Click Continue with Google. A Google OAuth consent screen opens.
2
Sign in and grant permissions
Sign in with the Google account that owns (or manages) your YouTube channel. Grant the requested permissions:
  • View your YouTube account
  • Manage your YouTube videos — required to post comment replies
  • View and manage your YouTube activity
3
Select the YouTube channel
If your Google account has multiple YouTube channels, select the one you want to monitor from the channel picker that appears after authorization.
4
Configure comment moderation rules
In the YouTube channel settings that appear, choose:
  • Videos to monitor — all videos, or specific video IDs
  • AI auto-reply — on/off and which comment topics trigger a reply
  • Hold for review — send AI drafts to the inbox for agent approval before posting
5
Test with a comment
Post a test comment on one of your YouTube videos. It should appear in the Moxabot inbox within 2–5 minutes (YouTube's comment webhook has a brief delay).
app.moxabot.com
Moxabot Integrations → YouTube settings page showing connected channel name, monitored videos selector, and auto-reply toggle
Integrations → YouTube — choose which videos to monitor and whether the AI replies automatically or drafts for review
💡
Tip:Enable Hold for review when you first connect YouTube. This lets you see AI draft replies in the inbox and approve them before they post publicly — a good way to tune the AI's tone before going fully automated.

Comment moderation modes

ModeBehaviour
Auto-reply (live)AI posts a reply directly on YouTube within minutes of a comment arriving.
Hold for reviewAI drafts a reply. An agent approves or edits it in the inbox before it posts.
Inbox onlyComments appear in the inbox for manual reply. AI does not draft a reply.
Monitor onlyComments are logged in the inbox for visibility. No reply is sent.
Moxabot
Inbox
Contacts
AI Persona
Knowledge
Integrations
Analytics
Team
Billing
YouTube
● Connected — Bright Tier Official
Active
Moderation settings
MonitorAll videos
AI repliesHold for review
SinceAll new comments
14 comments waiting for review in inbox

Plan limits

Channel availability depends on your Moxabot plan. The table below summarises which channels are included at each tier.

ChannelTrialStarterGrowthPro
Web Widget
WhatsApp Business✓ (counts as 1 channel)
Instagram / Messenger✓ (counts as 1 channel)
SMS via Twilio
SMS via EZ Texting
YouTube✓ (counts as 1 channel)
Max social channels02UnlimitedUnlimited
🚨
Heads up:The Starter plan allows a maximum of 2 social channels. If you need WhatsApp + Instagram + YouTube simultaneously, upgrade to Growth or above. SMS (both Twilio and EZ Texting) does not count toward the channel cap.

For full plan details, pricing, and upgrade instructions see the Billing & Plans guide.

Next steps

Set up your AI Persona and Knowledge BaseLearn the Inbox — assign, reply, and use macrosInvite your team and configure agent shiftsUnderstand your plan, seats, and usage limitsBack to Quick-start guide