# API de WhatsApp para software house — entrega el canal en el proyecto de tu cliente

> URL: https://wame.api.br/es/api-whatsapp-para-software-house
> Software house: deja de rehacer la integración de WhatsApp en cada proyecto. Un SDK, tres canales oficiales de Meta y un webhook — y una mensualidad tuya sobre cada cliente. Programa de Socios desde 20 instancias, sin permanencia.

## Para quienes entregan software a medida

WAME es la capa de mensajería de tu software house. Un SDK, tres canales oficiales de Meta y un webhook — el mismo código en cada proyecto que entregas. Y una mensualidad tuya sobre cada cliente.

Escribes la integración una vez. Sirve para todos los proyectos que entregues de aquí en adelante.

## Lo que rehaces en cada proyecto

El trabajo nunca fue enviar un mensaje. Es mantener viva una integración que ya entregaste y que ya no facturas.

**Rehaciéndolo en cada proyecto:**

- Crear una app en Meta for Developers por cada cliente
- Verificación de negocio a nombre del cliente — y la espera
- Un parser de webhook por canal, tres en total
- Soporte no facturado cada vez que Meta cambia la API
- Una estimación de 40 horas que se vuelve 200
- Proyecto entregado, ingresos terminados

**Con WAME por debajo:**

- Ninguna app en Meta — la infraestructura es nuestra
- Nada a nombre de tu cliente, nada de esperas
- Un solo parser para los tres canales
- Los cambios de API son problema nuestro, no tuyo
- Una integración previsible, del primer proyecto al décimo
- Proyecto entregado, mensualidad empezando

Somos Meta Business Partner. La infraestructura oficial ya está lista y mantenida de nuestro lado — tu equipo la consume y entrega.

## Lo que cambia en tu próxima propuesta

- **1 SDK** — Lo escribes una vez y lo reutilizas en cada proyecto: El módulo que hagas para el cliente de hoy entra en el siguiente sin cambios. La integración deja de ser una partida del presupuesto y pasa a ser biblioteca interna de la casa.
- **1 webhook** — Un handler sirve para los tres canales: WhatsApp, Instagram y Messenger llegan en el mismo sobre. Un solo campo indica el canal. El cliente que mañana pida Instagram no se convierte en un proyecto nuevo.
- **0 apps en Meta** — El trámite no es tuyo ni de tu cliente: Sin app aprobada, sin verificación de negocio a nombre de tu cliente, sin convertirte en Tech Provider. Desaparece la etapa que frena la entrega durante semanas y que nadie logra estimar.

## Tres canales. El mismo webhook

Escribes el handler una vez. Sirve para los tres — y para el siguiente cliente también.

- WhatsApp, Instagram y Messenger en el mismo formato de payload
- Oficial y no oficial con el mismo SDK y el mismo webhook
- La elección es por instancia — migra sin reescribir nada
- SDK en PHP y JavaScript

- **WhatsApp** — Cloud API oficial
- **Instagram** — Direct API oficial
- **Messenger** — Send API oficial

El evento que llega — solo cambia el campo provider:

```json
{
  "object": "wame",
  // whatsapp | instagram | messenger
  "provider": "instagram",
  "entry": [{
    "id": "<instance-id>",
    "changes": [{
      "field": "messages",
      "value": {
        "messages": [{
          "from": "5511999990000",
          "type": "text",
          "text": { "body": "Hi! 👋" }
        }]
      }
    }]
  }]
}
```

Tu lado — un módulo para los tres:

```js
// One module. Every project you deliver reuses it.
export function wameWebhook(req, res) {
  const { provider, entry } = req.body;
  const msg = entry[0].changes[0].value.messages?.[0];
  if (!msg) return res.sendStatus(200);

  onIncomingMessage({
    channel: provider,   // whatsapp | instagram | messenger
    from: msg.from,
    text: msg.text?.body,
  });

  res.sendStatus(200);
}
```

## Cómo encaja en el sistema que entregas

El cliente final nunca ve WAME. Ve WhatsApp funcionando dentro del sistema que tú hiciste.

1. **Creas la instancia por la API** — Crear, activar, desactivar y eliminar son llamadas tuyas. El aprovisionamiento ocurre dentro de tu propio onboarding — nadie abre un panel nuestro.
2. **Tu cliente conecta su cuenta** — Inicio de sesión seguro por la propia Meta en la oficial, o código QR en la no oficial. Elige WhatsApp, Instagram y/o Messenger.
3. **Todo llega a tu webhook** — Los tres canales en el mismo sobre, en la URL que configuraste. WhatsApp pasa a ser una función de tu sistema — no un proyecto aparte.

Gestión 100% por API. El ciclo de vida del cliente vive en tu facturación, no en nuestro panel — así que prueba, corte y reactivación son decisión tuya.

## La elección es por cliente, no por proveedor

No necesitas dos proveedores para atender dos tamaños de cliente. Misma plataforma, mismo SDK, mismo webhook.

### API oficial (Meta)

Para el cliente que necesita contrato, escala y el número a su nombre.

- Sin riesgo de bloqueo del número
- Coexistencia: tu cliente sigue atendiendo desde el móvil
- Instagram y Messenger en la misma instancia

### API no oficial (código QR)

Para el cliente pequeño que quiere empezar hoy y sin costo por conversación.

- Se conecta leyendo un código QR, sin aprobación
- Sin cobro de Meta por conversación
- Botones, listas, encuestas, grupos y Pix en el mensaje

Mover un cliente de una a otra no reescribe tu código: cambia la instancia y el handler sigue igual.

## De alcance cerrado a ingreso recurrente

Precio por volumen, una única factura mensual consolidada y permisos Enterprise en cada instancia. Desde 20 instancias, sin permanencia.

| instancias | Precio por instancia/mes |
|---|---|
| 20–99 | BRL 28,00 |
| 100–299 | BRL 24,00 |
| 300–799 | BRL 20,00 |
| 800+ | a consultar |

Solo el costo de la plataforma. En las instancias oficiales, las conversaciones las cobra Meta aparte, directo en la cuenta de tu cliente.

## Antes de que preguntes

**¿Y si el cliente quiere llevarse su número?**
El número es del cliente, y eso no cambia. En la API oficial la cuenta se crea en su propio Business Manager, así que puede irse cuando quiera — incluso de ti. Es incómodo decirlo en una página de ventas, pero es lo que separa a un socio de un rehén: quien se queda, se queda porque quiere.

**¿Puedo usarlo a nombre del cliente o tiene que ser al mío?**
Ambos funcionan. En la API oficial la cuenta de WhatsApp queda en el Business Manager del cliente y la instancia en tu cuenta de socio — él es dueño del número, tú eres dueño de la operación. Si prefieres concentrarlo todo a tu nombre, también se puede.

**¿Quién atiende al cliente final cuando algo falla?**
Tú, porque es tu marca la que da la cara. Pero a ti te atiende el equipo que construye la plataforma, directo, no un nivel 1 leyendo un guion. Fallos de canal, comportamiento raro del webhook y dudas de payload llegan a quien toca el código.

**¿El cliente puede no saber que WAME existe?**
Sí. Toda la gestión es por API, dentro de tu onboarding y de tu facturación. El cliente ve WhatsApp funcionando en el sistema que le entregaste; no hay un panel nuestro delante de él.

**Hoy solo tengo 3 clientes que piden WhatsApp. ¿Vale la pena?**
Para el programa de socios todavía no — empieza en 20 instancias. Pero puedes usar la plataforma por cliente desde ya y entrar al programa cuando llegue el volumen. El código no cambia; lo que cambia es la factura.

**¿Y si ya tengo una integración no oficial funcionando?**
No hace falta tirarla. Oficial y no oficial usan el mismo SDK y el mismo formato de webhook, y la elección es por instancia. Subes clientes nuevos a la oficial y migras los antiguos a tu ritmo, sin reescribir el handler.

## Entrega WhatsApp en el proyecto de tu cliente sin convertirte en una empresa de integración

Un SDK, tres canales, un webhook — y una línea de ingresos que no termina cuando termina el proyecto.

Desde 2017 en el mercado de API de mensajes · +50 mil instancias creadas · 99,9% de uptime · Meta Business Partner oficial

¿Tienes producto propio? Mira la página de CRM y SaaS: https://wame.api.br/es/whatsapp-api-para-crm-e-saas · Sobre la API oficial: https://wame.api.br/es/oficial · Todos los eventos: https://wame.api.br/es/docs/webhooks · Referencia de la API: https://wame.api.br/es/docs/api · Uptime público: https://wame.api.br/status