MKT X/Twitter Service - Documentation
Tài Liệu Dịch Vụ Twitter Marketing
English Documentation
| Document | Description | Link |
|---|---|---|
| README | Service overview, quick start, features | ../README.md |
| Architecture | System architecture, domain model, components | en/ARCHITECTURE.md |
| API Reference | Complete API documentation with examples | en/API.md |
| Twitter Setup | Step-by-step Twitter API integration guide | en/TWITTER_SETUP.md |
Tài Liệu Tiếng Việt
| Tài Liệu | Mô Tả | Link |
|---|---|---|
| README | Tổng quan dịch vụ, hướng dẫn nhanh | ../README.md |
| Kiến Trúc | Kiến trúc hệ thống, mô hình domain | vi/KIEN-TRUC.md |
| Thiết Lập Twitter | Hướng dẫn tích hợp Twitter API | vi/CAI-DAT-TWITTER.md |
Quick Links / Liên Kết Nhanh
Getting Started / Bắt Đầu
Architecture / Kiến Trúc
API / API
Setup / Thiết Lập
Service Features / Tính Năng Dịch Vụ
1. CHATBOT Automation Messenger
EN: Template-based messaging with workflows and scheduling
- Message template library
- Visual workflow designer
- Event-triggered messaging
- Campaign scheduling
- A/B testing
VI: Gửi tin nhắn dựa trên mẫu với workflows và lịch trình
- Thư viện mẫu tin nhắn
- Thiết kế workflow trực quan
- Tin nhắn kích hoạt sự kiện
- Lịch chiến dịch
- Kiểm thử A/B
2. CHATBOT AI Messenger
EN: AI-powered conversationsusing OpenAI
- Natural language understanding
- Intent detection
- Context-aware responses
- Auto escalation to human
VI: Trò chuyện được hỗ trợ AI dùng OpenAI
- Hiểu ngôn ngữ tự nhiên
- Phát hiện ý định
- Phản hồi theo ngữ cảnh
- Tự động chuyển cho người
3. Customer Management
EN: Complete CRM for Twitter contacts
- Contact profiles
- Segmentation
- Engagement analytics
- GDPR compliance
VI: CRM hoàn chỉnh cho liên hệ Twitter
- Hồ sơ liên hệ
- Phân khúc
- Phân tích tương tác
- Tuân thủ GDPR
API Endpoints Overview
Base URL: /api/v1/mkt-x
# Accounts / Tài Khoản
POST /accounts # Connect Twitter / Kết nối Twitter
GET /accounts # List / Danh sách
DELETE /accounts/{id} # Disconnect / Ngắt kết nối
# Contacts / Liên Hệ
GET /contacts # List / Danh sách
POST /contacts/{id}/tags # Add tags / Thêm nhãn
# Conversations / Hội Thoại
GET /conversations # List / Danh sách
POST /conversations/{id}/messages # Send / Gửi tin nhắn
# Campaigns / Chiến Dịch
POST /campaigns # Create / Tạo
POST /campaigns/{id}/start # Start / Bắt đầu
# Automation / Tự Động Hóa
POST /automation/flows # Create flow / Tạo workflow
# AI Chatbot
POST /ai/conversations/{id}/message # AI chat
# Analytics / Phân Tích
GET /analytics/overview # Dashboard / Bảng điều khiển
Full documentation / Tài liệu đầy đủ: en/API.md
Technology Stack / Công Nghệ
| Component | Technology | Version |
|---|---|---|
| Runtime | .NET | 8.0+ |
| Framework | ASP.NET Core | 8.0+ |
| Database | PostgreSQL | 15+ |
| Cache | Redis | 7+ |
| Message Broker | RabbitMQ | 3.12+ |
| Mediator | MediatR | 12+ |
External Dependencies / Dependencies Bên Ngoài
Required / Bắt Buộc
- Twitter API v2 - Direct Messages, Account Activity API
- PostgreSQL - Primary database
- Redis - Caching
- RabbitMQ - Message broker
Optional / Tùy Chọn
- OpenAI API - AI chatbot features / Tính năng chatbot AI
- Prometheus + Grafana - Monitoring / Giám sát
- Loki - Logging / Ghi log
Development Workflow / Quy Trình Phát Triển
1. Setup / Thiết Lập
# Restore dependencies / Cài dependencies
dotnet restore
# Setup database / Thiết lập database
dotnet ef database update --project src/MktXService.Infrastructure
2. Development / Phát Triển
# Run locally / Chạy local
dotnet run --project src/MktXService.API
# Run tests / Chạy tests
dotnet test
3. Deployment / Triển Khai
# Docker build
docker-compose build mkt-x-service-net
# Deploy / Triển khai
docker-compose up -d mkt-x-service-net
Support / Hỗ Trợ
For Developers / Dành Cho Lập Trình Viên
- Quick Start: README.md#quick-start
- API Questions: en/API.md
- Architecture: en/ARCHITECTURE.md
Issues / Vấn Đề
- Check documentation / Kiểm tra tài liệu
- Check logs / Kiểm tra logs:
docker-compose logs -f mkt-x-service-net - Health check:
curl http://localhost:5000/health - Contact support / Liên hệ hỗ trợ: api-support@goodgo.com
Related Services / Dịch Vụ Liên Quan
Last Updated: 2026-01-18
Maintained by: GoodGo Platform Team