MessageBird (Inbox) GTM Event Listener
Track MessageBird / Bird Inbox chat widget interactions in GTM. Monitor widget open, close, messages, and channel interactions with chatAction variable.
messagebirdbirdomnichannelchatgtmga4supportsmswhatsapp
Event fired
messageBirdEventKey variable
chatActionMessageBird
Overview
MessageBird (now Bird) is an omnichannel customer engagement platform supporting chat, SMS, WhatsApp, email, and more via its Inbox product. This listener hooks into Bird's JavaScript widget API to track interactions.
Event fired: messageBirdEvent
Variable: chatAction
Tracked Events
| chatAction | Description |
|---|---|
widget opened | Inbox widget opens |
widget closed | Widget closes |
channel selected | User picks channel (chat/WhatsApp/etc.) |
message sent | Visitor sends message |
message received | Agent replies |
conversation started | New conversation |
offline form submitted | Offline contact form |
Installation
html
<!-- GTM Custom HTML Tag: MessageBird Listener -->
<script>
(function() {
function mbPush(action, extra) {
window.dataLayer = window.dataLayer || [];
window.dataLayer.push(Object.assign({
'event': 'messageBirdEvent',
'chatAction': action
}, extra || {}));
}
var initMB = function() {
if (typeof window.MessageBird === 'undefined') return;
MessageBird.on('open', function() { mbPush('widget opened'); });
MessageBird.on('close', function() { mbPush('widget closed'); });
MessageBird.on('channelSelected', function(data) {
mbPush('channel selected', { selectedChannel: data.channel });
});
MessageBird.on('messageSent', function() { mbPush('message sent'); });
MessageBird.on('messageReceived', function() { mbPush('message received'); });
MessageBird.on('conversationStart', function() { mbPush('conversation started'); });
};
window.addEventListener('load', initMB);
})();
</script>Data Layer Output
json
{
"event": "messageBirdEvent",
"chatAction": "channel selected",
"selectedChannel": "whatsapp"
}Trigger Configuration
Trigger Type: Custom Event
Event Name: messageBirdEvent
Note on Omnichannel Tracking
Use selectedChannel to differentiate between chat, WhatsApp, SMS, and email interactions in GA4 reports.