Actualizado el 28/10/2026
Para una agencia, la forma más segura de gestionar la API de WhatsApp de varios clientes es mantener a cada cliente en su propio portafolio comercial de Meta, con su propia cuenta de WhatsApp y su propia cuenta de mensajes, y darle a la agencia acceso como socio. Así, el límite de envío, la calidad, las plantillas y el cobro quedan separados por cliente, y el número sigue siendo del cliente si el contrato termina. En lo técnico, la agencia centraliza todo en una sola integración y distingue a los clientes por el phone_number_id.
A continuación: estructura, acceso, cobro, plantillas, webhooks y reportes por cliente.
Un portafolio por cliente: por qué no juntar todo
Colgar todos los números del portafolio de la agencia parece más simple, pero varias reglas de Meta se calculan por portafolio o por cuenta, y eso mezcla el riesgo de un cliente con el de los demás.
| Elemento | Dónde vive en Meta | Qué pasa si todos los clientes están juntos |
|---|---|---|
| Límite de mensajes (destinatarios únicos fuera de la ventana en 24 h) | Portafolio comercial | Todos los números comparten el límite; la campaña de un cliente consume la capacidad de los otros |
| Verificación del negocio | Portafolio comercial | La verificación es de la empresa dueña del portafolio, no de cada cliente |
| Plantillas | Cuenta de mensajes | Plantillas de clientes distintos en la misma lista y con el mismo historial de calidad |
| Método de pago | Cuenta de mensajes | Una sola factura que la agencia tiene que repartir |
| Restricciones por incumplir la política | Cuenta de mensajes | Una mala campaña de un cliente puede bloquear el envío de los demás |
| Nombre visible | Número | Debe representar la empresa del cliente, no la agencia |
La documentación de límites de mensajes es clara: el límite es del portafolio y todos sus números comparten la misma cuota. Un portafolio nuevo empieza con 250 destinatarios únicos en 24 horas y sube a 2.000, 10.000, 100.000 e ilimitado. Con clientes separados, cada uno tiene su propia escalera de límite y su propia reputación. Y si el cliente cambia de agencia, el número se va con él, sin disputas.
La nueva estructura: cuenta de WhatsApp y cuenta de mensajes
Desde el 23/09/2026, la antigua WABA se dividió en dos. La cuenta de WhatsApp guarda el número. La cuenta de mensajes guarda plantillas, cobro y webhooks. Para la agencia, la consecuencia práctica es que el acceso y el cambio de proveedor pasan por la cuenta de WhatsApp: cambiar de proveedor es compartir la cuenta de WhatsApp del cliente con el nuevo socio. Lo explicamos en cuenta de WhatsApp vs. cuenta de mensajes.
¿Quieres probar mientras lees? Crea tu cuenta en Vectalk y envía el primer mensaje por la API oficial. Crear cuenta gratis →
Cómo obtiene la agencia acceso a los activos del cliente
Hay dos caminos comunes y muchas agencias usan los dos.
1. Registro insertado (Embedded Signup)
El registro insertado es el flujo de Meta, que se abre desde un sitio o portal, en el que el cliente inicia sesión, elige o crea el portafolio, registra el número y autoriza a la app a acceder a esos activos. La documentación para socios describe variantes para clientes que ya usan la app WhatsApp Business (coexistencia) y para cuentas creadas y compartidas desde Meta Business Suite.
En la práctica, el propio dueño del portafolio completa las pantallas en una llamada corta con la agencia, sin compartir contraseñas.
2. Acceso de socio al portafolio
Para tareas en el panel de Meta (WhatsApp Manager, plantillas, pagos, verificación), el cliente puede darle al portafolio de la agencia acceso a activos específicos como socio. Los pasos están en el servicio de ayuda de Meta: Cómo dar acceso a un socio a los activos de tu portafolio comercial.
Pide solo los activos que la agencia necesita, asigna el acceso a personas con nombre (nunca a un usuario compartido) y deja en el contrato que el administrador del portafolio es siempre el cliente.
Quién verifica el negocio
La verificación se hace en el portafolio del cliente, con documentos del cliente. Es uno de los caminos para subir el límite de 250 a 2.000. Según la página de límites, Meta también permite que el socio que hizo el onboarding verifique el negocio en nombre del cliente. Acuerden quién la lleva.
Quién le paga a Meta: tres modelos de cobro
Meta cobra por mensaje entregado, según la categoría y el país del destinatario. Hay tres modelos comunes:
| Modelo | Quién le paga a Meta | Cómo cobra la agencia al cliente |
|---|---|---|
| Cliente con método de pago propio | El cliente, directo en la cuenta de mensajes | La agencia cobra solo su servicio |
| Proveedor con línea de crédito | El proveedor, que factura al cliente | La agencia cobra su servicio; el proveedor factura el uso |
| Proxy gestionado (como Vectalk) | Vectalk le paga a Meta | Mensualidad más saldo prepago en Vectalk; cada mensaje entregado se descuenta del saldo; la agencia decide si lo traslada |
La documentación para socios explica que, con los proveedores de tecnología (Tech Providers), el cliente registra su propio método de pago y Meta le cobra el uso directamente; en cambio, los socios de soluciones (Solution Partners) pueden extender línea de crédito y facturar al cliente. Los tipos de socio se explican en qué es un BSP y un Tech Provider.
Si tus clientes envían mensajes a Brasil, estas son las tarifas oficiales de Meta en reales (BRL) desde el 1/10/2026:
| Categoría | Tarifa de Meta (Brasil) |
|---|---|
| Marketing | R$ 0,3217 por mensaje entregado |
| Utilidad | R$ 0,0350 |
| Autenticación | R$ 0,0350 |
| Servicio | R$ 0,0350, después de la franquicia de 1.000 al mes por número |
Para otros países, usa las tablas de la página de precios de Meta. Desde octubre de 2026, las plantillas de utilidad enviadas dentro de la ventana de atención también se cobran. Explícaselo al cliente antes de la primera factura. El artículo sobre mensajes de utilidad dentro de la ventana tiene los detalles.
Plantillas por cliente
Las plantillas viven en la cuenta de mensajes de cada cliente. Eso es bueno: si una plantilla se rechaza o se pausa, no afecta a los demás clientes. El trabajo de la agencia es mantener un estándar para no perderse entre decenas de cuentas.
Una convención que funciona:
| Parte del nombre | Ejemplo | Para qué |
|---|---|---|
| Finalidad | pedido_confirmado | Saber qué hace la plantilla |
| Variante | _v2 | Cambiar el texto sin borrar el historial |
Idioma (en el campo language) | es_MX | Tener versiones por idioma con el mismo nombre |
Mantén una biblioteca de textos aprobados por sector. Los modelos de plantilla por sector sirven de punto de partida. Antes de crear, revisa la categoría: el contenido promocional es marketing, aunque parezca un aviso. La guía cómo clasifica Meta tu plantilla explica los criterios.
En Vectalk, la creación de plantillas usa el token de la instancia del cliente, y la cuenta de mensajes se resuelve a partir del token:
curl -X POST https://apis.vectalk.com.br/api/templates \
-H "Authorization: Bearer TOKEN_INSTANCIA_CLIENTE_A" \
-H "Content-Type: application/json" \
-d '{
"name": "pedido_confirmado_v2",
"language": "es_MX",
"category": "UTILITY",
"components": [
{ "type": "BODY", "text": "Hola {{1}}, tu pedido #{{2}} fue confirmado.",
"example": { "body_text": [["Ana", "4821"]] } }
]
}'Webhooks y enrutamiento: una integración, varios clientes
Cada evento de la Cloud API llega con el phone_number_id en entry[].changes[].value.metadata. Así sabe la agencia de qué cliente es el mensaje. Un enrutador mínimo en Node.js, con el mapa de clientes en el código (en producción, en la base de datos):
const CLIENTES = {
'1098765432': { nombre: 'clinica-ejemplo', destino: 'https://crm.agencia.com/clinica' },
'2034567891': { nombre: 'tienda-ejemplo', destino: 'https://crm.agencia.com/tienda' },
};
export async function enrutar(evento) {
for (const entry of evento.entry ?? []) {
for (const change of entry.changes ?? []) {
const id = change.value?.metadata?.phone_number_id;
const cliente = CLIENTES[id];
if (!cliente) {
console.warn('phone_number_id sin cliente', id);
continue;
}
await fetch(cliente.destino, {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify(change.value),
});
}
}
}Si integras directo con Meta, valida la firma X-Hub-Signature-256 antes de enrutar; el paso a paso está en cómo validar la firma del webhook.
En Vectalk registras varias URL por instancia con POST /api/webhooks (por ejemplo, el CRM del cliente y el monitoreo de la agencia), y todas reciben el mismo evento.
Reportes por cliente
Separa por cliente y por mes: mensajes enviados, entregados, leídos y fallidos; envíos por categoría (lo que define el costo); errores recurrentes, como bajas de marketing; y tiempo de respuesta, si la agencia opera la atención. El costo estimado es la suma de entregados por categoría por la tarifa. Para métricas de atención, consulta métricas de atención en WhatsApp.
En Vectalk, GET /api/messages acepta filtros de periodo, estado y dirección. Con un token de instancia, la consulta ya queda limitada a ese cliente:
curl "https://apis.vectalk.com.br/api/messages?from=2026-10-01&to=2026-10-31&status=failed&direction=outbound" \
-H "Authorization: Bearer TOKEN_INSTANCIA_CLIENTE_A"Checklist para dar de alta a un cliente nuevo
- Portafolio propio del cliente, con él como administrador, y verificación iniciada.
- Número definido (nuevo o en coexistencia) y nombre visible con la marca del cliente.
- Cobro por escrito: quién le paga a Meta y cómo se traslada el uso.
- Opt-in de los contactos documentado por el cliente.
- Plantillas aprobadas, webhook probado con un mensaje real y reporte mensual acordado.
Cómo hacerlo con Vectalk
Vectalk es un proxy de la WhatsApp Cloud API oficial de Meta: los payloads y webhooks son los de Meta, y el cliente le paga a Vectalk, que le paga a Meta. Para agencias, tres funciones resuelven la mayor parte del trabajo:
- Una instancia por cliente. Cada número conectado es una instancia, creada con el registro insertado de Meta.
- Token de organización. Un token accede a todas las instancias; al enviar, indicas el
phone_number_iddel cliente en el cuerpo. Para plantillas y multimedia, usa el token de la instancia, como muestra la página de autenticación. - Webhooks por instancia, con varias URL para el mismo número.
Si quieres ofrecer la API oficial como parte de tu servicio, conoce el programa de socios de Vectalk, pensado para agencias, integradores y empresas de software. Las condiciones comerciales se definen caso por caso con el equipo. Para probar antes, crea una cuenta en apps.vectalk.com.br/register. Si recién empiezas con el tema, lee nuestra guía de la WhatsApp Cloud API.
Preguntas frecuentes
¿Puedo usar un número de la agencia para atender a varios clientes?
No es recomendable. El nombre visible y el perfil deben representar a la empresa que conversa con el cliente final, y la política de WhatsApp prohíbe hacerse pasar por otra empresa o confundir a quien recibe. Además, el límite y la calidad se compartirían entre todos.
Si el cliente deja la agencia, ¿pierde el número?
No, si el portafolio y la cuenta de WhatsApp son del cliente. Retira el acceso de la agencia y comparte la cuenta de WhatsApp con el nuevo socio. El artículo cómo cambiar de proveedor sin perder el número muestra el proceso.
¿La agencia necesita ser proveedor de tecnología de Meta?
Solo si quiere operar con su propia app en Meta. Ese camino exige verificación del negocio, revisión de la app y acceso avanzado a los permisos whatsapp_business_messaging y whatsapp_business_management, según la guía Get started for Tech Providers. Con un proveedor, la agencia se integra mediante la API de ese proveedor. Consulta directo con Meta o con un proveedor.
¿Varios clientes en el mismo portafolio comparten el límite?
Sí. El límite de mensajes se calcula por portafolio y lo comparten todos sus números. Por eso recomendamos un portafolio por cliente.
¿Quién es responsable del opt-in de los contactos?
El cliente, que es quien envía. La agencia puede armar formularios y flujos, pero la base y el consentimiento son del cliente, también ante las leyes de datos personales, como la LGPD de Brasil (Ley 13.709/2018) o la ley de tu país. Esto no es asesoría legal.
Fuentes oficiales consultadas el 28/10/2026: Límites de mensajes, Socios de la plataforma, Get started for Tech Providers, Dar acceso a un socio a los activos del negocio, Política de Mensajes de WhatsApp Business (actualizada el 23/09/2026), Precios, Documentación de Vectalk.
Pon a funcionar el WhatsApp oficial de tu empresa
Crea tu cuenta, conecta tu número a la API oficial (puedes mantener la app con coexistencia) y empieza a atender y enviar mensajes.