Messages

Handle Custom Channel Message

post

Handles incoming messages from custom channels. Campaign Assignment Priority - 1. Explicit campaignId (highest priority) 2. Keyword matching (existing logic) 3. Default campaign (fallback). Backwards Compatibility - All new fields are optional. Existing integrations continue to work unchanged.

Authorizations
Query parameters
apiKeystringOptional

API key for authentication

Example: your_api_key
Body
messageTypestringRequired

Type of message (e.g., text, reaction)

Default: text
Responses
200

Message processed successfully

application/json
post
POST /v1/incoming-custom-channel-message HTTP/1.1
Host: api.dmchamp.com
Content-Type: application/json
Accept: */*
Content-Length: 173

{
  "customData": {
    "messageSid": "msg123",
    "fromId": "user123",
    "toId": "business456",
    "body": "Hello from custom channel",
    "status": "received",
    "channel": "custom"
  },
  "messageType": "text"
}
{
  "success": true,
  "messageId": "1234567890"
}

Handle Custom Channel Message (Alternative)

post

Alternative endpoint for handling incoming messages from custom channels. Same functionality as /incoming-custom-channel-message. Campaign Assignment Priority - 1. Explicit campaignId (highest priority) 2. Keyword matching (existing logic) 3. Default campaign (fallback). Backwards Compatibility - All new fields are optional. Existing integrations continue to work unchanged.

Authorizations
Query parameters
apiKeystringOptional

API key for authentication

Example: your_api_key
Body
messageTypestringRequired

Type of message (e.g., text, reaction)

Default: text
Responses
200

Message processed successfully

application/json
post
POST /v1/incoming_custom_channel_message HTTP/1.1
Host: api.dmchamp.com
Content-Type: application/json
Accept: */*
Content-Length: 173

{
  "customData": {
    "messageSid": "msg123",
    "fromId": "user123",
    "toId": "business456",
    "body": "Hello from custom channel",
    "status": "received",
    "channel": "custom"
  },
  "messageType": "text"
}
{
  "success": true,
  "messageId": "1234567890"
}

Send Custom Channel Message

post

Send an outbound message to a custom channel contact. Creates contact if it doesn't exist.

Authorizations
Query parameters
apiKeystringOptional

API key for authentication

Example: your_api_key
Body
Responses
200

Message sent successfully

application/json
post
POST /v1/send-custom-channel-message HTTP/1.1
Host: api.dmchamp.com
Content-Type: application/json
Accept: */*
Content-Length: 105

{
  "customData": {
    "fromId": "user_123",
    "customChannel": "telegram",
    "body": "Hello! How can I help you today?"
  }
}
{
  "success": true,
  "messageId": "text",
  "contactId": "text",
  "message": "Message sent successfully"
}

Send Custom Channel Message (Alternative)

post

Alternative endpoint for sending outbound messages to custom channel contacts. Same functionality as /send-custom-channel-message. Creates contact if it doesn't exist.

Authorizations
Query parameters
apiKeystringOptional

API key for authentication

Example: your_api_key
Body
Responses
200

Message sent successfully

application/json
post
POST /v1/send_custom_channel_message HTTP/1.1
Host: api.dmchamp.com
Content-Type: application/json
Accept: */*
Content-Length: 105

{
  "customData": {
    "fromId": "user_123",
    "customChannel": "telegram",
    "body": "Hello! How can I help you today?"
  }
}
{
  "success": true,
  "messageId": "text",
  "contactId": "text",
  "message": "Message sent successfully"
}

Was this helpful?