Install channels

Custom Channel

Available on the Enterprise plan. A Custom Channel lets you bring any messaging system (in-app chat, SMS provider, marketplace chat) into the unified inbox.

1. Create the connection

Settings → Developer → Custom Channel → Connect. Provide a display name, an inbound signing secret and the outbound URL Pingloop should call with replies. You receive an inbound endpoint:

POST https://api.yourdomain.com/custom-channel/{connectionId}/inbound

2. Send inbound messages

curl -X POST https://api.yourdomain.com/custom-channel/CONN_ID/inbound \
  -H "Content-Type: application/json" \
  -H "X-Pingloop-Signature: sha256=$(echo -n "$BODY" | openssl dgst -sha256 -hmac "$SECRET" | cut -d' ' -f2)" \
  -d '{ "senderId": "user-123", "senderName": "Jane Doe", "text": "Hi, where is my order?", "timestamp": 1757577600 }'

Field	Required	Notes
`senderId`	yes	Stable id of the customer in your system
`senderName`	no	Used for the contact name on first message
`text`	one of text / attachments	Message body
`attachments`	no	`[{ "type": "image", "url": "…" }]`
`postbackPayload`	no	Button click payload, drives Flows
`timestamp`	no	Unix seconds or milliseconds

3. Receive replies

Pingloop POSTs each agent, AI or automation reply to your outbound URL:

{
  "recipientId": "user-123",
  "message": { "type": "TEXT", "text": "Your order ships tomorrow." },
  "sentAt": "2026-09-11T10:00:00.000Z"
}

Signed with X-Pingloop-Signature when an outbound secret is configured.

Viber Unified inbox