X (Twitter)

Connecting an X (Twitter) channel lets you receive Direct Messages and mentions as PingBack conversations. Agents can reply from within PingBack and the reply is posted back on X.

X is available on the Mini and Pro plans only.

Prerequisites

Before you start, you need an X Developer App with the following settings configured in the X Developer Portal:

App permissions: Read and Write
Direct Message access: Enabled
All four credentials generated: API Key, API Key Secret, Access Token, and Access Token Secret
A Bearer Token for the app

Setup

Gather your X credentials

From your X Developer App dashboard, collect the following five values:

Field	Where to find it
`api_key`	App Keys and Tokens > API Key
`api_secret`	App Keys and Tokens > API Key Secret
`access_token`	App Keys and Tokens > Access Token
`access_token_secret`	App Keys and Tokens > Access Token Secret
`bearer_token`	App Keys and Tokens > Bearer Token

Create the X channel in PingBack

Send a POST request to /api/v1/channels/ with type set to "x" and all five credentials in the config object.

curl -X POST https://api.pingback.live/api/v1/channels/ \
  -H "Authorization: Bearer <your_token>" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "x",
    "config": {
      "api_key": "xxxxxxxxxxxxxxxxxxxxxxxxx",
      "api_secret": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
      "access_token": "0000000000-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
      "access_token_secret": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
      "bearer_token": "AAAAAAAAAAAAAAAAAAAAAxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
    },
    "is_active": true
  }'

{
  "id": 74,
  "type": "x",
  "is_active": true,
  "config": {
    "api_key": "xxxxxxxxxxxxxxxxxxxxxxxxx",
    "api_secret": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "access_token": "0000000000-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "access_token_secret": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "bearer_token": "AAAAAAAAAAAAAAAAAAAAAxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
  }
}

If either api_key or access_token is missing, PingBack will reject the request with a 400 error.

Webhook registration (automatic)

PingBack automatically registers a webhook endpoint for your X channel at:

https://api.pingback.live/api/v1/webhooks/x/{channel_id}

Where {channel_id} is the numeric id returned in the response above. You may need to register this URL as the webhook endpoint in your X Developer App’s Dev Environments section if you are using the Account Activity API.

Test the connection

Send a Direct Message to your connected X account from another account. The message should appear as a new conversation in your PingBack inbox within seconds.

Get Started

Core Concepts

Channels

AI Assistant

Realtime & Webhooks

Plans & Billing

Prerequisites

Setup

​Prerequisites

​Setup

Prerequisites

Setup