@redonvn/messaging-x
v1.0.0
Published
Enterprise X (Twitter) API v2 Direct Messages & Conversations SDK with CRC Challenge & x-twitter-webhooks-signature
Keywords
Readme
@redai/messaging-x — Official X (Twitter) Direct Messages API v2 & Account Activity SDK
Enterprise TypeScript SDK cho nền tảng X (Twitter) thuộc hệ sinh thái RedAI Omnichat, được thiết kế theo kiến trúc Speakeasy 4-Layer và tương thích 100% với hợp đồng đa kênh IMessagingProvider.
Tính năng nổi bật
- 6 Sub-SDKs chuyên biệt (46 phương thức):
client.messages: Gửi DM 1-1 (POST /2/dm_conversations/with/:participant_id/messages), gửi DM vào hội thoại (POST /2/dm_conversations/:dm_conversation_id/messages), tạo Group DM (POST /2/dm_conversations), Quick Replies (options), CTA Buttons (ctas), xóa DM (DELETE /2/dm_events/:event_id), Typing Indicator & Mark Read.client.conversations: Bao phủ toàn bộ 4 GET DM v2 Endpoints (listAllDmEvents,getParticipantDmEvents,getConversationDmEvents,getDmEventById) và 8 phương thức quản trị Hội thoại Bài đăng / Bình luận công khai (/2/tweets:replyToTweet,postTweet,deleteTweet,hideReply,getConversationThread,getUserMentions,likeTweet,unlikeTweet).client.media: Quy trình Chunked Media Upload chuẩn (INIT,APPEND,FINALIZE,STATUS) chodm_image,dm_gif,dm_video,tweet_image,tweet_videokèm Alt Text (setMediaMetadata).client.users: Tra cứu hồ sơ người dùng (/2/users/me,/2/users/:id,/2/users/by/username/:username) & Quản lý vòng đời OAuth 2.0 PKCE Token (exchangeCodeForToken,refreshOAuth2Token,revokeOAuth2Token).client.subscriptions: Quản trị Account Activity Webhooks & User Subscriptions (registerWebhook,listWebhooks,triggerCrcCheck,deleteWebhook,subscribeAccountActivity,unsubscribeAccountActivity).client.webhook: Xử lý GET CRC Challenge (crc_token$\rightarrow$sha256=<base64>) định kỳ 24h, xác thực chữ kýx-twitter-webhooks-signaturevà chuẩn hóa 5 nhóm sự kiện Account Activity.
Cài đặt
pnpm add @redai/messaging-x @redai/messaging-common @redai/coreKhởi tạo nhanh
import { XMessagingClient } from '@redai/messaging-x';
const xClient = new XMessagingClient({
accessToken: process.env.X_ACCESS_TOKEN!,
consumerSecret: process.env.X_CONSUMER_SECRET!,
clientId: process.env.X_CLIENT_ID,
clientSecret: process.env.X_CLIENT_SECRET,
webhookEnvName: 'production',
});
// Gửi tin nhắn DM 1-1
const res = await xClient.messages.sendTextToParticipant(
'2244994945',
'Xin chào từ RedAI Omnichat!'
);