Prueba gratis
API oficial · Cloud API de Meta

API oficial de WhatsApp con tu número, en minutos

Sin fila de homologación, sin ticket de soporte y sin quitar el número del celular: entras con tu cuenta de Meta, eliges el número que ya está en WhatsApp Business y haces el primer POST. La tarifa de Meta la pagas directo a Meta — nosotros no le ponemos margen.

Sin tarjetaSin permanenciaUS$ 19 por número al mesTarifa de Meta sin margenLa misma API del código QR

POST /api/WhatsGw/Send
$ curl -X POST https://app.whatsgw.com.br/api/WhatsGw/Send \
  -H "Content-Type: application/json" \
  -d '{
    "apikey": "TU_APIKEY",
    "phone_number": "525500000000",
    "contact_phone_number": "525500000001",
    "message_custom_id": "pedido-4821",
    "message_type": "text",
    "message_body": "¡Hola, Marina! Tu pedido 4821 salió hoy 🚚",
    "check_status": 1
  }'
$ch = curl_init('https://app.whatsgw.com.br/api/WhatsGw/Send');
curl_setopt_array($ch, [
  CURLOPT_POST => true,
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
  CURLOPT_POSTFIELDS => json_encode([
    'apikey' => 'TU_APIKEY',
    'phone_number' => '525500000000',
    'contact_phone_number' => '525500000001',
    'message_custom_id' => 'pedido-4821',
    'message_type' => 'text',
    'message_body' => '¡Hola, Marina! Tu pedido 4821 salió hoy 🚚',
    'check_status' => 1,
  ]),
]);
echo curl_exec($ch);
const r = await fetch('https://app.whatsgw.com.br/api/WhatsGw/Send', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    apikey: 'TU_APIKEY',
    phone_number: '525500000000',
    contact_phone_number: '525500000001',
    message_custom_id: 'pedido-4821',
    message_type: 'text',
    message_body: '¡Hola, Marina! Tu pedido 4821 salió hoy 🚚',
    check_status: 1
  })
});
console.log(await r.json());
import requests

r = requests.post('https://app.whatsgw.com.br/api/WhatsGw/Send', json={
    'apikey': 'TU_APIKEY',
    'phone_number': '525500000000',
    'contact_phone_number': '525500000001',
    'message_custom_id': 'pedido-4821',
    'message_type': 'text',
    'message_body': '¡Hola, Marina! Tu pedido 4821 salió hoy 🚚',
    'check_status': 1,
})
print(r.json())
var http = new HttpClient();
var envio = new {
  apikey = "TU_APIKEY",
  phone_number = "525500000000",
  contact_phone_number = "525500000001",
  message_custom_id = "pedido-4821",
  message_type = "text",
  message_body = "¡Hola, Marina! Tu pedido 4821 salió hoy 🚚",
  check_status = 1
};
var resp = await http.PostAsJsonAsync(
  "https://app.whatsgw.com.br/api/WhatsGw/Send", envio);
Console.WriteLine(await resp.Content.ReadAsStringAsync());
Haz clic en el código para seleccionarlo todo. Cambia la API key y los teléfonos — el resto ya es el payload real.
respuesta{ "result": "success", "result_message": "…" }
¡Hola, Marina! Tu pedido 4821 salió hoy 🚚
1 popupde la propia Meta: entra con Facebook, elige el número y listo — sin abrir el Business Manager
0% de margensobre la tarifa de Meta: Meta cobra en tu cuenta, a su precio de lista según el país del destinatario
1 endpoint/WhatsGw/Send para oficial y código QR — cambiar el tipo de conexión no cambia tu código
desde 2019más de 2000 clientes, más de 500 millones de mensajes procesados, disponibilidad superior al 99%
La parte tediosa

¿Ya intentaste integrar directo con Meta?

Una app en el panel de desarrollador, token temporal, usuario del sistema, webhook con verificación y firma, plantillas en el Business Manager — y, al final, el número que usa tu equipo queda fuera, porque mantener el número en la aplicación exige acreditación como socio. Aquí eso ya está hecho.

App acreditada en MetaEntras al popup oficial con tu cuenta y conectas el número de WhatsApp Business — la configuración de socio corre por nuestra cuenta.
Token, webhook y registroAPI key fija en lugar de un token que expira; los eventos de Meta llegan listos a tu webhook; el registro del número se hace en el retorno.
Plantillas por la APICrea, envía a aprobación y sigue el estado sin abrir el Business Manager — y envía por el mismo Send.
Antes de empezar

Tres cosas para tener a mano — y la conexión sale a la primera

Casi toda conexión oficial que se traba, se traba por falta de una de estas tres. Revísalas antes de hacer clic.

Cuenta de Meta Business con método de pago

Meta cobra sus mensajes en tu portafolio empresarial. Registra la tarjeta antes de conectar — sin método de pago, el número queda pendiente en Meta.

Dónde: business.facebook.com → Configuración → Pagos.

El número en WhatsApp Business, con el celular a mano

En el popup de Meta escaneas un QR con WhatsApp Business. El número sigue en el teléfono: tu equipo sigue atendiendo y tu aplicación envía y recibe por la API.

Alternativa: un número nuevo, sin WhatsApp instalado, se convierte en una cuenta dedicada en la nube — misma API.

Verificación del negocio: opcional para conectar

No se exige para empezar. Sin ella, Meta permite 250 contactos únicos por día; la verificación sube el límite, que crece según la calidad de tus envíos.

Consejo: inicia la verificación en Meta Business en paralelo, mientras ya integras.
Cómo funciona

De la cuenta al primer POST en cuatro pasos

Sin fila de aprobación de nuestra parte, sin nadie «liberando» tu cuenta. Lo haces tú solo, a tu ritmo.

Crea la cuenta

Correo o cuenta de Google, sin tarjeta. Incluye 25 mensajes gratis para probar.

Conecta con Meta

Nueva instancia → Oficial → Iniciar conexión con Meta. En el popup: entra a Facebook, elige el portafolio, escanea el QR con WhatsApp Business. El número sigue en el celular.

Copia la API key

En Administración → Teléfonos. Es fija — nada de tokens que expiran en 24 horas ni usuario del sistema.

Haz el primer POST

Copia el ejemplo de arriba, cambia la clave y los teléfonos. Pide un «hola» al destinatario y el mensaje libre sale al instante.

¿Quién inicia la conversación?

Si el cliente te escribió en las últimas 24 horas, cualquier texto, imagen, video, PDF o ubicación sale por Send, como en el ejemplo de arriba.

Para que tú inicies la conversación, Meta exige una plantilla aprobada. La creas y la envías a aprobación desde la propia API (NewTemplate → SendTemplateToProvider), la sigues con SyncTemplateStatus y la envías por el mismo Send con el bloque template. Encabezado con imagen, video o PDF y variables en el cuerpo.

{
  "apikey": "TU_APIKEY",
  "phone_number": "525500000000",
  "contact_phone_number": "525500000001",
  "message_custom_id": "pedido-4821",
  "message_type": "text",
  "message_body": "",
  "template": {
    "id": 22,
    "components": [
      { "type": "body",
        "parameters": [ { "type": "text", "text": "Marina" } ] }
    ]
  }
}
Coexistencia

Tu número sigue en el celular. La API trabaja a su lado.

  • Nada cambia para tu equipo: sigue atendiendo por WhatsApp Business en el teléfono, mientras tu aplicación envía y recibe por la API — en el mismo número.
  • Todo el historial en tu sistema: lo que tu equipo escribe en la app también llega a tu webhook, como mensaje enviado.
  • Sin segunda línea: ningún chip nuevo, ninguna portabilidad, ningún «anota nuestro nuevo número».
  • ¿Prefieres una cuenta dedicada en la nube? Conecta un número sin WhatsApp instalado y Meta lo registra como Cloud API. La API es la misma.
  • La cuenta es tuya: la WhatsApp Business Account queda en tu portafolio de Meta. El número y el historial son tuyos.

WhatsApp Business en el celular

Tu equipo atiende, responde audios, manda fotos — como siempre.

un número+52 55 0000 0000

Tu aplicación por la API

Notificación, cobranza, confirmación, bot — y el webhook de todo.

¿Directo con Meta o por WhatsGW?

Qué cambia cuando integras por aquí

La Cloud API por debajo es la misma. Lo que WhatsGW te quita del camino está en la tabla — y lo que sigue siendo tuyo también.

CriterioDirecto con MetaPor WhatsGW
Mantener el número en WhatsApp Business del celularSolo con acreditación de socio en MetaIncluido — se conecta por el popup
Hasta el primer envíoApp, token, usuario del sistema, webhook, plantillaPopup de Meta + 1 POST
AutenticaciónToken temporal o usuario del sistemaAPI key fija
WebhookTú alojas el endpoint de Meta, con verificación y firmaTu URL recibe el JSON listo, con tu message_custom_id
MultimediaSubida a Meta y envío por idURL o base64 en el propio POST
PlantillasBusiness ManagerPor la API o por el panel
Oficial y código QR en la misma integraciónNoMisma API, elección por número
Atención humana, CRM y agente de IA en el mismo númeroNoIncluidos en el panel
Dueño de la cuenta WhatsApp Business (WABA)TúTú — queda en tu portafolio de Meta
Para integradores y SaaS

Conecta a los clientes de tu sistema sin volverte socio acreditado

  • Crea la instancia por la API con type: 3 y recibe un direct_link para enviar a tu cliente.
  • El cliente se conecta solo: abre el enlace, entra con su cuenta de Meta y elige su número. Nada de configurar app o token para cada uno.
  • Sigues el estado por GetInstance o por el webhook, y cada cliente paga la tarifa de Meta en su propia cuenta.
  • Sin límite de números por cuenta. Más de 25 números, condición especial.
// POST /api/WhatsGw/NewInstance
{
  "apikey": "TU_APIKEY",
  "type": 3,
  "config": {
    "description": "Cliente 4821",
    "webhook_url": "https://tu-sistema.com/whatsgw"
  }
}

// respuesta: envía el direct_link a tu cliente
{
  "result": "success",
  "w_instancia_id": 138683,
  "tipo": 3,
  "direct_link": "https://app.whatsgw.com.br/W-….aspx"
}
Experiencia de desarrollador

REST puro, documentación viva y gente que integra todos los días

  • POST con JSON (o form-urlencoded); GET cuando aplique. Sin SDK obligatorio.
  • Respuesta asíncrona con check_status: entregado y leído llegan a tu webhook con tu message_custom_id, para vincularlo al pedido.
  • Texto, imagen, video, PDF y ubicación en la oficial; plantillas con encabezado multimedia y variables en el cuerpo.
  • Contrato OpenAPI para importar en Postman o generar el cliente; ejemplos en GitHub en PHP, Node, Python, C# y Delphi.
  • Soporte técnico por WhatsApp, de quien ya conectó cientos de números en Meta.
PHPNode.jsPythonC#Delphicurl
Webhook · evento recibido
message_statusPOST a tu endpoint
{ "message_custom_id": "pedido-4821", "status": "read", "contact_phone_number": "525500000001" }
✓ entregado 09:41✓✓ leído 09:43
/WhatsGw/Send/WhatsGw/GetTemplates/WhatsGw/NewTemplate/WhatsGw/SendTemplateToProvider/WhatsGw/SyncTemplateStatus/WhatsGw/NewInstance/WhatsGw/GetInstance/WhatsGw/PhoneState/WhatsGw/GetEvents
Precio predecible

US$ 19 por número al mes. La tarifa de Meta, al precio de Meta.

Prepago, sin permanencia, sin costo de configuración. Mensajes ilimitados de nuestro lado; o por mensaje, si lo prefieres. Se cobra en reales brasileños (R$ 99) por PayPal; tu banco lo convierte a tu moneda.

  • US$ 19 por número al mes — oficial o código QR, el mismo precio
  • O por mensaje, escalonado: de R$ 0,120 (≈ US$ 0.023) a R$ 0,023 (≈ US$ 0.0044) según el volumen
  • API, webhooks, plantillas y chat multiagente incluidos
  • 25 mensajes gratis para probar, sin tarjeta · más de 25 números, condición especial

Lo que cobra Meta — por mensaje, según el país del destinatario

Marketingsegún el país
Utilidad (pedido, cobranza, aviso)según el país
Autenticación (código)según el país
Servicio (respuesta libre en la ventana de 24 h)según el país
Mensaje recibido del clientegratis
Conversación iniciada por anuncio click-to-WhatsApp (72 h)gratis
Lo cobra Meta directo en tu cuenta, sin traspaso ni margen de WhatsGW. Meta fija la tarifa por mensaje según el país del destinatario y la categoría (marketing, utilidad, autenticación) — y cambia; consulta la tabla oficial.
Preguntas frecuentes

Lo que preguntan los desarrolladores antes de conectar

¿Tengo que quitar el número de WhatsApp Business del celular?

No. El número sigue en el teléfono y tu equipo sigue atendiendo por él; tu aplicación envía y recibe por la API en el mismo número (coexistencia). Si prefieres una cuenta dedicada en la nube, conecta un número sin WhatsApp instalado — la API es la misma.

¿Necesito la verificación del negocio en Meta para conectar?

No. Conectas con la cuenta de Meta Business y un método de pago registrado. Sin verificación, Meta permite 250 contactos únicos por día; la verificación sube el límite, que crece con la calidad de los envíos.

¿Puedo iniciar la conversación o solo responder?

Dentro de las 24 horas posteriores al último mensaje del cliente, cualquier texto o multimedia sale por Send. Para iniciar la conversación, Meta exige una plantilla aprobada: la creas y la envías a aprobación por la API (NewTemplate, SendTemplateToProvider), la sigues con SyncTemplateStatus y la envías por el mismo Send con el bloque template.

¿Cuánto cuesta de verdad?

US$ 19 por número al mes, con mensajes ilimitados de nuestro lado (o el plan por mensaje, de R$ 0,120 (≈ US$ 0.023) a R$ 0,023 (≈ US$ 0.0044)). Además, Meta cobra su tarifa directo en tu cuenta — por mensaje, según el país del destinatario y la categoría (marketing, utilidad, autenticación); consulta la tabla oficial de Meta. WhatsGW no traslada ni agrega nada en esa parte. Se cobra en reales brasileños (R$ 99) por PayPal; tu banco lo convierte a tu moneda.

¿La cuenta de WhatsApp Business (WABA) es mía o de WhatsGW?

Es tuya: queda en tu portafolio de Meta Business. El número, las plantillas y el historial son tuyos.

¿Qué tipos de mensaje acepta la conexión oficial?

Texto, imagen, video, documento (PDF y otros) y ubicación, por URL o base64. Fuera de la ventana de 24 horas, plantillas aprobadas — con encabezado de imagen, video o documento y variables en el cuerpo.

Ya uso WhatsGW por código QR. ¿Puedo migrar a la oficial?

Sí. Crea la instancia oficial, conecta el número por el popup de Meta y cambia el phone_number en tus llamadas. Endpoint, payload y webhook son los mismos — y puedes mantener los dos tipos en la misma cuenta.

Soy integrador. ¿Cómo conecto a los clientes de mi sistema?

Crea la instancia por la API con type: 3 en NewInstance: la respuesta trae un direct_link. Envía el enlace al cliente; él entra con su cuenta de Meta y conecta su número. Síguelo por GetInstance o por el webhook. Cada cliente paga la tarifa de Meta en su propia cuenta.

Conecta tu número hoy

Crea la cuenta, entra con tu cuenta de Meta y haz el primer POST. Sin tarjeta, sin permanencia — y sin margen sobre la tarifa de Meta.

API oficial · con tu númeroConectar gratis
WhatsApp