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!Những điểm chính
- Self-host & Multi-tenant: Triển khai trên cơ sở hạ tầng của bạn, hỗ trợ nhiều tổ chức độc lập trong cùng một instance.
- AI Agent sẵn sàng: Tích hợp agent nhẹ hoặc kết nối agent ngoài qua giao thức Chat Completions/A2A, kèm tools như MCP client, SQL client.
- Tích hợp sâu Meta: Dùng chính thức WhatsApp Cloud API và Instagram API, hỗ trợ trở thành Meta Business Partner.
- Plugin Claude Code & MCP: Cho phép điều khiển API qua Claude Desktop hoặc các agent platform khác.
- Dễ migrate: Hướng dẫn chi tiết chuyển từ Twilio hoặc whatsapp-web.js, bảo đảm dữ liệu di động được.
OpenBSP API là gì và giải quyết vấn đề gì?
OpenBSP API là một nền tảng mã nguồn mở được xây dựng trên Deno và Supabase, cung cấp backend hoàn chỉnh để kết nối với các APIs chính thức của Meta (WhatsApp Cloud API và Instagram API). Nó lưu trữ tất cả hội thoại vào PostgreSQL qua Supabase, hỗ trợ multi-tenant ngay từ thiết kế, và có sẵn cơ chế AI agent. Vấn đề nó giải quyết: thay vì dùng các nền tảng đóng như Twilio hay các thư viện không chính thức (whatsapp-web.js) dễ bị block, bạn có một giải pháp self-host tuân thủ chính sách Meta, cho phép mở rộng, tùy biến và kiểm soát dữ liệu. Bạn có thể xem chi tiết tại repository gốc trên GitHub.
Tính năng nổi bật nào của OpenBSP API?
OpenBSP API có nhiều tính năng đáng chú ý: Multi-tenant – mỗi tổ chức có môi trường cô lập riêng. WhatsApp Account Coexistence – cho phép kết nối tài khoản WhatsApp Business hiện có qua Embedded Signup mà không cần tạo mới. AI Agent – tạo agent nhẹ với tools có sẵn (MCP client, SQL client, HTTP client, Calculator) hoặc kết nối agent ngoài (OpenAI, Anthropic, Google). Media Processing – trích xuất thông tin từ ảnh, video, PDF, audio, CSV, HTML, TXT. Claude Code Plugin – plugin cho Claude Code để query contacts, conversations, templates và reply WhatsApp messages real-time. MCP Server – server chuẩn MCP cho phép truy cập API từ Claude Desktop hoặc agent platform khác. Webhook & API – tích hợp ngoài dễ dàng. Ngoài ra, nó hỗ trợ migration từ Twilio (chỉ cần đăng ký lại template) và từ whatsapp-web.js (chuyển từ unofficial sang official API).
Hướng dẫn cài đặt và sử dụng OpenBSP API
Cài đặt OpenBSP API khá đơn giản, bạn có thể triển khai trong vòng 15 phút mà không cần môi trường local. Dưới đây là các bước cơ bản:
- Fork repository – Fork repo
matiasbattocchia/open-bsp-apivề tài khoản GitHub của bạn. - Tạo Supabase project – Tạo một project Supabase mới (miễn phí là đủ để dùng thử).
- Kết nối Supabase GitHub Integration – Vào Supabase Dashboard > Project Settings > Integrations, cấp quyền và chọn fork repo của bạn. Thiết lập thư mục làm việc là
.và nhánh production làmain. - Thiết lập Vault secrets – Tạo secrets
edge_functions_url(có dạnghttps://{SUPABASE_PROJECT_ID}.supabase.co/functions/v1) vàedge_functions_token(là SUPABASE_SERVICE_ROLE_KEY). - Kích hoạt deploy lần đầu – Tạo một file mới trong repo (ví dụ
.trigger_deploy) và commit. Lần deploy đầu sẽ tự động chạy. - Cấu hình WhatsApp integration – Tạo Meta App, system user, lấy
META_SYSTEM_USER_ID,META_SYSTEM_USER_ACCESS_TOKEN,META_APP_ID,META_APP_SECRET,WHATSAPP_VERIFY_TOKENvà thêm vào secrets. Cập nhật webhook callback URL và subscribe các fields cần thiết. - Đăng ký phone number – Thêm số điện thoại WhatsApp và insert vào bảng
organizations_addressesvới thông tin WABA và phone number ID.
Sau khi cài đặt, bạn có thể truy cập web UI quản lý qua companion project OpenBSP UI (React + Tailwind) hoặc dùng Claude Code plugin để tương tác. Nếu muốn dùng nhanh, có thể dùng bản hosted tại web.openbsp.dev với quota 5000 tin nhắn/tháng miễn phí.
Ai nên dùng và ai không nên dùng OpenBSP API?
Nên dùng nếu: Bạn là doanh nghiệp hoặc service provider muốn quản lý WhatsApp và Instagram Business một cách chuyên nghiệp, cần self-host để kiểm soát dữ liệu, muốn sẵn sàng trở thành Meta Business Partner, hoặc cần tích hợp AI agent và automation. Developer muốn tùy biến sâu hạ tầng nhắn tin cũng sẽ thấy OpenBSP API rất phù hợp. Không nên dùng nếu: Bạn chỉ cần gửi tin nhắn cá nhân qua tài khoản WhatsApp Web (không phải Business Account), vì OpenBSP API dùng official Cloud API chỉ hỗ trợ WhatsApp Business Account. Nếu bạn cần các tính năng không có trên Cloud API như quản lý nhóm, poll, status thì nên xem các thư viện unofficial (whatsapp-web.js, Baileys,…). Nếu bạn không muốn tự triển khai và không muốn tự quản lý Meta App thì bản hosted có thể đáp ứng nhưng giới hạn quota.
Câu hỏi thường gặp
OpenBSP API có miễn phí không?
Có, mã nguồn mở hoàn toàn miễn phí. Bạn chỉ tốn chi phí cho Supabase project (có gói miễn phí) và Meta App (cũng miễn phí). Nếu dùng bản hosted, bạn có 5000 tin nhắn/tháng miễn phí.
OpenBSP API có hỗ trợ Instagram không?
Có, ngoài WhatsApp còn hỗ trợ Instagram Business API. Bạn cần cấu hình riêng các secrets INSTAGRAM_APP_ID, INSTAGRAM_APP_SECRET và INSTAGRAM_VERIFY_TOKEN.
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 với WABA mới, còn logic xử lý tin nhắn gần như tương tự vì cùng dùng Meta Cloud API.
OpenBSP API có thể dùng với Claude Desktop không?
Có, thông qua MCP server. Bạn chỉ cần lấy API key từ OpenBSP Settings, cấu hình claude_desktop_config.json và có thể chat với WhatsApp/Instagram thông qua Claude.
Tôi có thể trở thành Meta Business Partner nhờ OpenBSP API không?
Repo được thiết kế để hỗ trợ quá trình trở thành Meta Business Partner. Bạn có thể cung cấp dịch vụ nhắn tin cho các tổ chức khác dựa trên nền tảng này, nhưng việc được Meta công nhận là Meta Business Partner đòi hỏi quy trình riêng.
Kết luận
OpenBSP API là một dự án mã nguồn mở đầy hứa hẹn cho bất kỳ ai muốn chủ động quản lý kênh WhatsApp và Instagram Business. Với kiến trúc self-host, multi-tenant, hỗ trợ AI agent và tích hợp sâu với hệ sinh thái Meta, nó mang lại sự linh hoạt và kiểm soát mà các nền tảng đóng không thể có. Nếu bạn đang tìm kiếm một giải pháp nhắn tin doanh nghiệp mở, hãy fork repo, dùng thử bản hosted hoặc bắt đầu triển khai ngay hôm nay. Đừng quên tham gia cộng đồng WhatsApp của dự án để được hỗ trợ và cập nhật.
