DM Champ Help Guide

Explore

DM Champ Help Guide

GHL (and others) Integration

⁠

Load content from embed.voomly.com? Loading external content may reveal information to 3rd parties. Learn more Allow⁠

⁠

Connecting DM Champ to GoHighLevel (GHL): Complete Integration Guide

Overview

DM Champ can be integrated with GoHighLevel using two main workflows that enable two-way communication. This guide will walk you through setting up both workflows to create a seamless messaging experience across all channels.

Prerequisites

Active DM Champ account

GoHighLevel account with workflow permissions

Your DM Champ API key (found in Settings > Accounts)

Workflow 1: Send Message to DM Champ

This workflow sends messages from GHL to DM Champ when messages are received on any channel.

Step 1: Create the Workflow

Navigate to GHL Workflows

Click "Create New Workflow"

Name it "Send Message to DM Champ"

Step 2: Add Triggers

Add all applicable triggers:

When SMS message received

When Email received

When Facebook message received

When Instagram DM received

When Live Chat message received

Step 3: Optional Tag Filter

Click "Add Filter"

Select "Contact has tag"

Choose your specific tags

Select if contact should have "any" or "all" tags

Step 4: Create Channel Split

Add "Condition" action

Create branches based on "Message Source":

Branch 1: Message source equals "Email"

Branch 2: Message source equals "SMS"

Branch 3: Message source equals "Messenger"

Branch 4: Message source equals "Instagram"

Branch 5: Message source equals "Live Chat"

Step 5: Configure Webhooks

For each branch, add a webhook with these settings:

Method: POST

URL: https://api.dmchamp.com/v1/incoming_custom_channel_message?apiKey=YOUR_API_KEY

Custom Data

messageSid {{right_now.second}}{{contact.id}}

fromId {{contact.id}}

toId {{user.id}}

body {{message.body}}

channel [email/sms/messenger/ig/livechat] (use appropriate channel for each branch)

status created

messageType text

Workflow 2: Send DM Champ Message to Contact

This workflow handles messages sent from DM Champ back to contacts in GHL.

Step 1: Create Inbound Webhook

In GHL, go to Settings > Developers/API

Click "Create New Webhook"

Select "Inbound Webhook"

Name it "DM Champ Messages"

Save and copy the webhook URL

Step 2: Configure DM Champ

Log into DM Champ

Go to Settings > Account

Paste the GHL webhook URL

Send a test message using Live Chat to trigger the webhook

Example webhook payload:

{

"contactId": "NtL97bwnhITrfIq8lWFi",

"messageId": "s28dtg13qNuhXLoKpcLs",

"userId": "wpDZRvaw4Hgh4whUBpwlKPRftOi2",

"body": "Message content here",

"toId": "qtpBsc6fiqkXTnSOeze3",

"channel": "email"

}

Step 3: Create Response Workflow

Go to GHL Workflows

Click "Create New Workflow"

Name it "Send DM Champ Message to Contact"

Step 4: Configure Workflow Settings

Select "Inbound Webhook" as trigger

Add "Find Contact" action

Search by Contact ID: {{inboundWebhookRequest.toId}}

Optional: Add tag check condition

Add "Condition" action for specific tags

End workflow if tags don't match

Add channel split condition based on {{inboundWebhookRequest.channel}}

Branch 1: equals "email"

Branch 2: equals "sms"

Branch 3: equals "messenger"

Branch 4: equals "ig"

Branch 5: equals "livechat"

For each branch, add appropriate send message action:

Email Branch: "Send Email" action

SMS Branch: "Send SMS" action

Messenger Branch: "Send Facebook Message" action

Instagram Branch: "Send Instagram Message" action

Live Chat Branch: "Send Chat Message" action

In each send message action, use {{inboundWebhookRequest.body}} as the message content

Testing the Integration

Test Workflow 1

Send a message through each channel in GHL

Verify messages appear in DM Champ

Check channel labeling is correct

Verify contact information is properly linked

Test Workflow 2

Send a message from DM Champ - if AI is one this will be done automatically

Verify contact is found in GHL

Confirm message is sent through correct channel

Check message content is accurate

Troubleshooting

Common Issues

Messages not reaching DM Champ:

Verify API key is correct

Check webhook URL formatting

Confirm trigger conditions are met

Check Workflow settings and make sure re-entry is allowed.

Messages not reaching GHL:

Verify webhook URL in DM Champ

Check contact ID matching

Check Workflow settings and make sure re-entry is allowed.

Channel Issues:

Verify channel values match exactly

Confirm account connections for social channels

Want to print your doc?
This is not the way.

Try clicking the ⋯ next to your doc name or using a keyboard shortcut (

CtrlP

) instead.