Who can use this?
- Available on the Advanced plan.
- Roles: Owners and Admins to get the channel ID; any member can open the embedded conversation once they are logged in.
- Someone who can edit your CRM or portal needs to add the iFrame.
The Conversation Widget lets you open a Gallabox WhatsApp conversation inside your own CRM or internal portal, so your team can chat with a contact without switching to Gallabox. You embed it as an iFrame and pass the contact’s phone number in the URL.
This page is more technical than most — you’ll likely want a developer to add the iFrame to your CRM or portal.
Before You Start
- Decide which page in your CRM or portal will host the widget, for example the lead or contact detail page.
- Have the contact’s phone number available on that page, with the country code and no
+. - If your account has more than one WhatsApp channel, get the channel ID from Settings → WhatsApp Channel → Channel Id.
Embed the widget in an iFrame
Point the iFrame at this URL:
Example:
The team member viewing the page must already be logged in to Gallabox in the same browser. If they aren’t, the widget shows the Gallabox login screen. To skip that, use auto-login below.
Auto-login with a specific member
Use this when you want the widget to open as one particular Gallabox member, without asking them to log in first.1
Get an authentication token
Call the login endpoint from your server with that member’s Gallabox email and password:The response contains the member’s authentication token.
2
Load the iFrame with the auth URL
Pass the token and the widget URL you want to land on:
redirectUrl is the conversation URL from the section above, URL-encoded. For example:If that member has two-factor authentication enabled, or logs in from a new IP address, the widget shows an OTP screen. After they verify, it continues to the redirect URL.
FAQs
The widget shows a login screen instead of the conversation.
The widget shows a login screen instead of the conversation.
The member viewing your CRM page isn’t logged in to Gallabox in that browser. Ask them to log in to Gallabox in another tab and reload the page, or set up auto-login as described above.
Do I need the channelId?
Do I need the channelId?
Only if your account has more than one WhatsApp channel. With a single channel you can leave it out. Find it in Settings → WhatsApp Channel → Channel Id.
What happens if the phone number has no conversation yet?
What happens if the phone number has no conversation yet?
The widget opens a conversation for that number on the selected channel. Standard WhatsApp rules still apply — outside the 24-hour window you can only start with an approved template. See Message Credits.
Can I use this to embed the whole Gallabox inbox?
Can I use this to embed the whole Gallabox inbox?
No — the widget is scoped to one contact’s conversation at a time. For the full inbox, your team uses the Gallabox app.
Related Articles
- Zoho Lead Panel — view Zoho CRM lead details inside Gallabox conversations
- Generic Webhooks — send data into Gallabox from any system
- Two-Factor Authentication — how 2FA affects member logins