POST
/api/genesys/sms/inbound
Telnyx inbound message webhook - forwards SMS to Genesys Cloud Open Messaging
Request Body
{
"data": {
"event_type": "message.received",
"payload": {
"id": "msg_123",
"from": {
"phone_number": "+12125551234"
},
"text": "Hello",
"tags": ["+12125551234", "listId", "contactId"]
}
}
}Event Types
| Event | Action |
|---|
message.received | Forward to Genesys Cloud |
message.sent | Update contact list status |
message.finalized | Update contact list status |
POST
/api/webhooks/telnyx/insights
Verified Telnyx insights webhook for conversation.insights.completed, call.conversation_insights.generated, and conversation_insight_result
Configure this URL on an AI Insight Group. The endpoint verifies the exact raw request body with TELNYX_PUBLIC_KEY before accepting the event.
| Required header | Value |
|---|
telnyx-signature-ed25519 | Base64 Ed25519 signature |
telnyx-timestamp | Unix timestamp with a five-minute replay window |
POST
/api/genesys/sms/outbound
Genesys Cloud outbound message webhook - sends SMS via Telnyx
Request Body
{
"type": "Text",
"text": "Hello from agent",
"channel": {
"to": {
"id": "+12125551234|listId|contactId"
}
}
}Headers
| Header | Value |
|---|
x-hub-signature-256 | HMAC SHA-256 signature |
Content-Type | application/json |
POST
/api/genesys/sms/agentless
Send SMS without agent assignment
Request Body
{
"number": "+12125551234",
"text": "Your message here"
}Response
{
"success": true,
"conversationId": "abc-123"
}Message Tags & Campaign Tracking
How to track campaign delivery status in Genesys contact lists
Messages can include tags for campaign tracking. Format: number|listId|contactId
Contact List Fields (Auto-Updated)
| Field | Description |
|---|
TELNYX_STATUS | Delivery status (sent, delivered, etc.) |
TELNYX_TIME | Timestamp (ISO 8601) |
TELNYX_PRICE | Message cost (USD) |
TELNYX_MESSAGE_ID | Telnyx message ID |
TELNYX_MESSAGE | Message text |