OpenBSP API là nền tảng mã nguồn mở tự triển khai (self-host) giúp bạn quản lý tin nhắn WhatsApp và Instagram Business một cách chuyên nghiệp. Nó giải quyết bài toán phụ thuộc vào dịch vụ đóng và cho phép bạn kiểm soát hoàn toàn dữ liệu, luồng vận hành cũng như mở rộng quy mô dễ dàng. Dành cho developer, doanh nghiệp và nhà cung cấp dịch vụ muốn làm chủ hạ tầng nhắn tin.

Thank you for reading this post, don't forget to subscribe!

OpenBSP API là gì? OpenBSP API là một nền tảng mã nguồn mở, self-host, xây dựng trên Deno và Supabase, cung cấp backend hoàn chỉnh để kết nối với 2 API chính thức của Meta: WhatsApp Cloud API và Instagram API. Toàn bộ hội thoại được lưu trong PostgreSQL qua Supabase, hỗ trợ multi-tenant ngay từ thiết kế, kèm cơ chế AI agent, MCP server, webhook và plugin Claude Code. Theo repository gốc, bạn có thể triển khai trong 15 phút và bản hosted có quota 5.000 tin nhắn/tháng miễn phí. Điểm mạnh nhất là bạn kiểm soát toàn bộ hạ tầng, không bị ràng buộc bởi nền tảng đóng, đồng thời có thể dùng nó làm bước đệm để trở thành Meta Business Partner.

OpenBSP API có gì khác biệt so với Twilio và whatsapp-web.js?

Khác biệt lớn nhất nằm ở ba điểm: bạn có mã nguồn để tự vận hành, kiến trúc multi-tenant sẵn sàng cho nhà cung cấp dịch vụ, và dùng chính thức Meta Cloud API nên không lo bị chặn như thư viện không chính thức. Twilio là SaaS đóng, còn whatsapp-web.js xây trên WebSocket của WhatsApp Web.

Để dễ hình dung, hãy đối chiếu ba phương án qua bảng dưới đây:

Tiêu chí	OpenBSP API	Twilio	whatsapp-web.js
Loại giải pháp	Mã nguồn mở, self-host	SaaS API đóng	Thư viện không chính thức
API nền tảng	WhatsApp Cloud API + Instagram API	Twilio WhatsApp API	WhatsApp Web (WebSocket)
Chi phí	Chi phí hạ tầng + phí Meta theo hội thoại	Phí theo tin nhắn và kênh	Miễn phí nhưng rủi ro chặn
Multi-tenant	Có sẵn	Không có	Không có
AI Agent / MCP	Có sẵn	Phải tự tích hợp	Không
Độ tuân thủ Meta	Cao (official API)	Cao	Thấp, vi phạm ToS

Nếu bạn cần một giải pháp nhanh, không muốn vận hành hạ tầng, Twilio là lựa chọn ổn định. Nếu bạn chấp nhận rủi ro để gửi tin nhắn số lượng nhỏ qua WhatsApp Web, whatsapp-web.js có thể dùng tạm. Nhưng nếu bạn muốn làm chủ hệ thống, phục vụ nhiều khách hàng và phát triển lâu dài, OpenBSP API là hướng đi bền vững hơn. Bạn có thể xem thêm tài liệu Twilio WhatsApp để hiểu rõ cách họ tính phí.

Kiến trúc self-host và multi-tenant của OpenBSP API hoạt động thế nào?

OpenBSP API dùng Deno cho tầng edge functions và Supabase làm lớp dữ liệu PostgreSQL. Mỗi tổ chức được cô lập qua bảng organizations, hội thoại và cấu hình đều gắn với tenant đó. Nhờ vậy, một instance duy nhất có thể phục vụ nhiều khách hàng mà không xung đột dữ liệu.

Kiến trúc này tương tự cách các BSP (Business Solution Provider) vận hành. Khi một doanh nghiệp đăng ký, bạn tạo organization mới, cấp phone number và system user riêng. Dữ liệu hội thoại được lưu theo tenant, nên việc backup, export hay xoá theo yêu cầu đều làm được. Nếu chạy trên một VPS, bạn có thể cài thêm Docker, Nginx và giám sát bằng Prometheus. Theo tài liệu Supabase, GitHub Integration cho phép deploy edge functions trực tiếp từ repo, đây chính là cách OpenBSP API cập nhật code.

Chi phí vận hành OpenBSP API trên Supabase và Meta Cloud API là bao nhiêu?

Chi phí gồm hai phần: hạ tầng Supabase và phí Meta Cloud API. Bạn có thể bắt đầu với Supabase free tier, đủ cho dự án demo. Khi lên production, gói Pro khoảng 25 USD/tháng cho database, auth và edge functions. Meta không thu phí hàng tháng mà tính theo từng loại hội thoại.

Theo bảng giá Supabase, gói free tier bao gồm 500 MB PostgreSQL và 5 GB bandwidth, trong khi gói Pro bắt đầu từ 25 USD/tháng. Về phía Meta, tài liệu WhatsApp Cloud API phân loại hội thoại thành 4 loại: service, utility, authentication và marketing; mỗi loại có biểu giá riêng. Nếu doanh nghiệp gửi nhiều tin marketing, chi phí Meta sẽ lớn hơn chi phí hạ tầng.

Lộ trình triển khai OpenBSP API từ GitHub đến production

Bạn hoàn toàn có thể đưa OpenBSP API lên production trong một ngày nếu đã có Meta Business Manager. Quy trình gồm fork repo, tạo Supabase project, cấu hình secrets, tạo Meta App, đăng ký phone number và kiểm thử webhook. Sau đó, bạn migrate dữ liệu từ Twilio hoặc whatsapp-web.js nếu cần.

Các bước cụ thể đã được mô tả trong repository gốc trên GitHub. Điểm quan trọng là bạn cần tạo đúng các secrets như META_SYSTEM_USER_ID, META_SYSTEM_USER_ACCESS_TOKEN, WHATSAPP_VERIFY_TOKEN. Sau khi deploy lần đầu qua Supabase GitHub Integration, mọi thay đổi code sẽ tự động đồng bộ. Nếu bạn từng dùng Twilio, chỉ cần đăng ký lại template trên WABA mới, còn logic nhắn tin gần như giữ nguyên vì cùng dùng Meta Cloud API.

Hạn chế của OpenBSP API khi dùng WhatsApp Cloud API chính thức là gì?

Hạn chế đến từ chính Meta Cloud API: không quản lý nhóm, không xem status, không gửi tin nhắn qua tài khoản WhatsApp thường. Bạn bắt buộc dùng WhatsApp Business Account, và tin nhắn marketing phải được phê duyệt template. Ngoài ra, bạn tự vận hành hạ tầng nên phải lo giám sát và backup.

Nếu mô hình của bạn cần tính năng nhóm, broadcast không cần template hay đọc trạng thái online, các thư viện như whatsapp-web.js hoặc Baileys có thể đáp ứng, nhưng đánh đổi bằng rủi ro khóa số. Mặt khác, vì OpenBSP API là self-host, bạn phải tự xử lý bảo mật server, cập nhật phiên bản và xoay vòng token Meta. Điều này đòi hỏi nhân sự có kinh nghiệm vận hành hệ thống.

Làm sao để dùng AI Agent và MCP Server trong OpenBSP API?

Bạn có thể dùng AI agent ngay trong OpenBSP API hoặc kết nối agent ngoài qua giao thức Chat Completions. MCP server mở ra kênh kết nối cho Claude Desktop, Claude Code và các agent platform khác. Bạn chỉ cần vào Settings lấy API key, thêm cấu hình vào file claude_desktop_config.json là có thể chat với WhatsApp.

OpenBSP API cung cấp sẵn các tools như MCP client, SQL client, HTTP client và Calculator. Bạn cũng có thể dùng AI Agent để tự động trả lời hội thoại, ghi chú khách hàng hoặc tổng hợp hội thoại. Với Claude Code, có sẵn plugin để query contacts, conversations, templates và reply WhatsApp messages real-time. Bên cạnh đó, bạn có thể tích hợp AI agent cho các kịch bản chăm sóc khách hàng. Chức năng trích xuất thông tin từ ảnh, PDF, CSV giúp agent hiểu ngữ cảnh tin nhắn. Theo Anthropic, giao thức MCP ra mắt vào tháng 11/2024.

Câu hỏi thường gặp

OpenBSP API có miễn phí không?

Phần mềm mã nguồn mở hoàn toàn miễn phí. Bạn chỉ tốn chi phí cho hạ tầng Supabase (có free tier) và phí Meta Cloud API theo hội thoại. Nếu dùng bản hosted, bạn được miễn phí 5.000 tin nhắn/tháng.

Tôi có thể migrate từ Twilio sang OpenBSP API không?

Có. Repository có hướng dẫn chi tiết. Về cơ bản, bạn cần đăng ký lại WhatsApp template trên WABA mới, còn logic xử lý tin nhắn gần như tương tự vì cả hai đều dùng Meta Cloud API.

OpenBSP API có hỗ trợ Instagram không?

Có. Ngoài WhatsApp, nó hỗ trợ Instagram Business API. Bạn cần cấu hình thêm các secrets INSTAGRAM_APP_ID, INSTAGRAM_APP_SECRET và INSTAGRAM_VERIFY_TOKEN.

Làm sao để trở thành Meta Business Partner?

OpenBSP API được thiết kế để hỗ trợ bạn cung cấp dịch vụ nhắn tin cho nhiều tổ chức. Việc trở thành Meta Business Partner đòi hỏi doanh nghiệp của bạn đạt yêu cầu về doanh số, chất lượng dịch vụ và quy trình riêng của Meta, không tự động từ mã nguồn mở.

OpenBSP API có phù hợp với doanh nghiệp nhỏ không?

Nếu bạn chỉ có một số điện thoại và vài nhân viên, bản hosted hoặc free tier là đủ. Khi lượng hội thoại tăng, bạn nên chuyển sang self-host để kiểm soát chi phí và dữ liệu.

Bởi Ban biên tập ngoctraimkt.com – nhóm chuyên gia triển khai chatbot cho doanh nghiệp vừa và nhỏ.