# Wapisimo

> Wapisimo is a multi-tenant WhatsApp API for developers. Connect a number by
> scanning a QR code from the WhatsApp app, or bring your own WhatsApp Business
> Account and use the official Cloud API. Same HTTP API either way.
> $5 per phone number per month either way. Messaging is unlimited on QR-paired
> numbers; Cloud API numbers follow Meta's own rules and pricing.

## Two ways to connect

- **QR pairing** — scan a QR code from WhatsApp on the handset, the same way
  WhatsApp Web links a device. No Meta app review, no Business verification, no
  template approval queue. Setup takes minutes.
- **Official Cloud API** — if you already have a WhatsApp Business Account and a
  Meta app, connect them and Wapisimo routes through Meta's official Cloud API.
  Message templates are supported on this path.

Both expose the same endpoints, the same webhook payloads and the same event
history, so application code written against one works against the other.

## Features

- Simple HTTP API for sending text, media, location and template messages
- Real-time webhooks for inbound messages and connection events
- Queryable event history as the durable record behind those webhooks
- Phone groups for managing several numbers under one id
- Wapisimo Assistant: connect an OpenAI API key and let AI handle selected
  conversations, with handoff to a human when needed
- Encrypted communications and per-phone credential scoping

## Pricing

$5 per phone number per month, QR or Cloud API, with no separate platform fee.
Messaging is unlimited on QR-paired numbers; Cloud API numbers follow Meta's own
rules and pricing. Billing is by active phone count and deleting a phone frees
its slot. A High Quality tier with a dedicated egress IP is available at
additional cost per number.

## Getting started

1. Sign up at https://app.wapisimo.dev and copy the account API key from Settings
2. `POST /v1/phones` to create a phone
3. `GET /v1/{phone_id}/qr` and scan the code from WhatsApp on the handset
4. `POST /v1/{phone_id}/webhook` to register where inbound events go
5. `POST /v1/{phone_id}/send` to send

## Links

- API documentation: https://app.wapisimo.dev/llms-full.txt
- OpenAPI specification: https://app.wapisimo.dev/openapi.json
- Agent authentication guide: https://wapisimo.dev/auth.md
- Blog: https://wapisimo.dev/blog/en
- Terms of service: https://wapisimo.dev/terms-of-service