matiasbattocchia/open-bsp-api — Open-source WhatsApp + Instagram Business platform

Description and use

**Brief Summary**
matiasbattocchia/open‑bsp‑api is an open‑source TypeScript platform that implements a unified Business Service Protocol (BSP) for WhatsApp and Instagram Business, enabling AI assistants to interact with real‑world messaging tools through a standard API. With over 400 ⭐ on GitHub, recent commits, and a growing ecosystem, it offers a ready‑to‑use backend, database layer, and optional CLI/SDK for rapid integration.

**Value**
The project abstracts the disparate APIs of WhatsApp and Instagram Business into a single, consistent protocol, letting developers plug AI agents, chatbots, or automation workflows into both channels without writing custom adapters. This standardization reduces integration overhead, accelerates time‑to‑market for AI‑driven customer‑service solutions, and facilitates the deployment of Model Context Protocol (MCP) servers that can query live business data.

**Practical Adoption Path**

1. **Evaluate** – Clone the repo, run the provided Docker compose or npm scripts, and test the sample endpoints with the bundled CLI.
2. **Configure** – Supply your WhatsApp and Instagram Business credentials via environment variables or a secure vault; the platform handles token refresh and webhook registration automatically.
3. **Integrate** – Use the generated TypeScript SDK or the RESTful API to connect your AI assistant (e.g., OpenAI, LangChain) to the BSP endpoints, mapping intents to messaging actions.
4. **Extend** – Add custom database models or webhook handlers for domain‑specific logic, leveraging the built‑in PostgreSQL integration.
5. **Deploy** – Deploy to a cloud provider (Kubernetes, Fly.io, etc.) using the provided Helm chart or Docker image; monitor with the built‑in health checks and Prometheus metrics.

**Production Readiness**

• **Activity & Community**: Last commit on 2026‑06‑28, 422 stars, 177 forks, and active issue discussions indicate a healthy maintainer base.
• **Architecture**: Typed TypeScript code, modular SDK/CLI, and Docker‑ready deployment make it suitable for scaling and CI/CD pipelines.
• **Security & Licensing**: No immediate metadata risks, but a final audit of the MIT‑style license and dependency vulnerabilities is recommended before a full production rollout.

Overall, the project is mature enough for a serious pilot or production use, provided the standard security review and any required custom compliance checks are completed.

Problem

matiasbattocchia/open-bsp-api helps connect AI assistants to real tools and data through a standard protocol.

Outcome

High for an OSS candidate: recent activity, adoption, and ecosystem signals are strong enough for a serious pilot.

Workflow

• connect AI agents to tools
• ship Model Context Protocol servers
• standardize integrations

Evidence

Open-source WhatsApp + Instagram Business platform

Source