🤖GHL (and others) Integration

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

1. Navigate to GHL Workflows

2. Click "Create New Workflow"

3. 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

1. Click "Add Filter"

2. Select "Contact has tag"

3. Choose your specific tags

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

Step 4: Create Channel Split

1. Add "Condition" action

2. 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

1. In GHL, go to Settings > Developers/API

2. Click "Create New Webhook"

3. Select "Inbound Webhook"

4. Name it "DM Champ Messages"

5. Save and copy the webhook URL

Step 2: Configure DM Champ

1. Log into DM Champ

2. Go to Settings > Account

3. Paste the GHL webhook URL

4. 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

1. Go to GHL Workflows

2. Click "Create New Workflow"

3. Name it "Send DM Champ Message to Contact"

Step 4: Configure Workflow Settings

1. Select "Inbound Webhook" as trigger

2. Add "Find Contact" action

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

3. Optional: Add tag check condition

   • Add "Condition" action for specific tags

   • End workflow if tags don't match

4. 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"

5. 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

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

Testing the Integration

Test Workflow 1

1. Send a message through each channel in GHL

2. Verify messages appear in DM Champ

3. Check channel labeling is correct

4. Verify contact information is properly linked

Test Workflow 2

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

2. Verify contact is found in GHL

3. Confirm message is sent through correct channel

4. Check message content is accurate

Troubleshooting

Common Issues

1. 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.

2. Messages not reaching GHL:

   • Verify webhook URL in DM Champ

   • Check contact ID matching

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

3. Channel Issues:

   • Verify channel values match exactly

   • Confirm account connections for social channels