{"id":566,"date":"2026-10-28T16:08:27","date_gmt":"2026-10-28T16:08:27","guid":{"rendered":"https:\/\/vectalk.com.br\/blog\/api-whatsapp-para-agencias-es\/"},"modified":"2026-10-28T16:08:36","modified_gmt":"2026-10-28T16:08:36","slug":"api-whatsapp-para-agencias-es","status":"publish","type":"post","link":"https:\/\/vectalk.com.br\/blog\/es\/api-whatsapp-para-agencias-es\/","title":{"rendered":"API de WhatsApp para agencias: c\u00f3mo gestionar el WhatsApp de varios clientes"},"content":{"rendered":"\n

Actualizado el 28\/10\/2026<\/em><\/p>\n\n\n\n

Para una agencia, la forma m\u00e1s 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\u00ed, el l\u00edmite de env\u00edo, la calidad, las plantillas y el cobro quedan separados por cliente, y el n\u00famero sigue siendo del cliente si el contrato termina. En lo t\u00e9cnico, la agencia centraliza todo en una sola integraci\u00f3n y distingue a los clientes por el phone_number_id<\/code>.<\/p>\n\n\n\n

A continuaci\u00f3n: estructura, acceso, cobro, plantillas, webhooks y reportes por cliente.<\/p>\n\n\n\n

Un portafolio por cliente: por qu\u00e9 no juntar todo<\/h2>\n\n\n\n

Colgar todos los n\u00fameros del portafolio de la agencia parece m\u00e1s 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\u00e1s.<\/p>\n\n\n\n

Elemento<\/th>D\u00f3nde vive en Meta<\/th>Qu\u00e9 pasa si todos los clientes est\u00e1n juntos<\/th><\/tr><\/thead>
L\u00edmite de mensajes (destinatarios \u00fanicos fuera de la ventana en 24 h)<\/td>Portafolio comercial<\/td>Todos los n\u00fameros comparten el l\u00edmite; la campa\u00f1a de un cliente consume la capacidad de los otros<\/td><\/tr>
Verificaci\u00f3n del negocio<\/td>Portafolio comercial<\/td>La verificaci\u00f3n es de la empresa due\u00f1a del portafolio, no de cada cliente<\/td><\/tr>
Plantillas<\/td>Cuenta de mensajes<\/td>Plantillas de clientes distintos en la misma lista y con el mismo historial de calidad<\/td><\/tr>
M\u00e9todo de pago<\/td>Cuenta de mensajes<\/td>Una sola factura que la agencia tiene que repartir<\/td><\/tr>
Restricciones por incumplir la pol\u00edtica<\/td>Cuenta de mensajes<\/td>Una mala campa\u00f1a de un cliente puede bloquear el env\u00edo de los dem\u00e1s<\/td><\/tr>
Nombre visible<\/td>N\u00famero<\/td>Debe representar la empresa del cliente, no la agencia<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

La documentaci\u00f3n de l\u00edmites de mensajes<\/a> es clara: el l\u00edmite es del portafolio y todos sus n\u00fameros comparten la misma cuota. Un portafolio nuevo empieza con 250 destinatarios \u00fanicos 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\u00edmite y su propia reputaci\u00f3n. Y si el cliente cambia de agencia, el n\u00famero se va con \u00e9l, sin disputas.<\/p>\n\n\n\n

La nueva estructura: cuenta de WhatsApp y cuenta de mensajes<\/h2>\n\n\n\n

Desde el 23\/09\/2026, la antigua WABA se dividi\u00f3 en dos. La cuenta de WhatsApp<\/strong> guarda el n\u00famero. La cuenta de mensajes<\/strong> guarda plantillas, cobro y webhooks. Para la agencia, la consecuencia pr\u00e1ctica 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<\/a>.<\/p>\n\n\n\n

C\u00f3mo obtiene la agencia acceso a los activos del cliente<\/h2>\n\n\n\n

Hay dos caminos comunes y muchas agencias usan los dos.<\/p>\n\n\n\n

1. Registro insertado (Embedded Signup)<\/h3>\n\n\n\n

El registro insertado es el flujo de Meta, que se abre desde un sitio o portal, en el que el cliente inicia sesi\u00f3n, elige o crea el portafolio, registra el n\u00famero y autoriza a la app a acceder a esos activos. La documentaci\u00f3n para socios<\/a> describe variantes para clientes que ya usan la app WhatsApp Business (coexistencia) y para cuentas creadas y compartidas desde Meta Business Suite.<\/p>\n\n\n\n

En la pr\u00e1ctica, el propio due\u00f1o del portafolio completa las pantallas en una llamada corta con la agencia, sin compartir contrase\u00f1as.<\/p>\n\n\n\n

2. Acceso de socio al portafolio<\/h3>\n\n\n\n

Para tareas en el panel de Meta (WhatsApp Manager, plantillas, pagos, verificaci\u00f3n), el cliente puede darle al portafolio de la agencia acceso a activos espec\u00edficos como socio. Los pasos est\u00e1n en el servicio de ayuda de Meta: C\u00f3mo dar acceso a un socio a los activos de tu portafolio comercial<\/a>.<\/p>\n\n\n\n

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.<\/p>\n\n\n\n

Qui\u00e9n verifica el negocio<\/h3>\n\n\n\n

La verificaci\u00f3n se hace en el portafolio del cliente, con documentos del cliente. Es uno de los caminos para subir el l\u00edmite de 250 a 2.000. Seg\u00fan la p\u00e1gina de l\u00edmites, Meta tambi\u00e9n permite que el socio que hizo el onboarding verifique el negocio en nombre del cliente. Acuerden qui\u00e9n la lleva.<\/p>\n\n\n\n

Qui\u00e9n le paga a Meta: tres modelos de cobro<\/h2>\n\n\n\n

Meta cobra por mensaje entregado, seg\u00fan la categor\u00eda y el pa\u00eds del destinatario. Hay tres modelos comunes:<\/p>\n\n\n\n

Modelo<\/th>Qui\u00e9n le paga a Meta<\/th>C\u00f3mo cobra la agencia al cliente<\/th><\/tr><\/thead>
Cliente con m\u00e9todo de pago propio<\/td>El cliente, directo en la cuenta de mensajes<\/td>La agencia cobra solo su servicio<\/td><\/tr>
Proveedor con l\u00ednea de cr\u00e9dito<\/td>El proveedor, que factura al cliente<\/td>La agencia cobra su servicio; el proveedor factura el uso<\/td><\/tr>
Proxy gestionado (como Vectalk)<\/td>Vectalk le paga a Meta<\/td>Mensualidad m\u00e1s saldo prepago en Vectalk; cada mensaje entregado se descuenta del saldo; la agencia decide si lo traslada<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

La documentaci\u00f3n para socios explica que, con los proveedores de tecnolog\u00eda (Tech Providers), el cliente registra su propio m\u00e9todo de pago y Meta le cobra el uso directamente; en cambio, los socios de soluciones (Solution Partners) pueden extender l\u00ednea de cr\u00e9dito y facturar al cliente. Los tipos de socio se explican en qu\u00e9 es un BSP y un Tech Provider<\/a>.<\/p>\n\n\n\n

Si tus clientes env\u00edan mensajes a Brasil, estas son las tarifas oficiales de Meta en reales (BRL) desde el 1\/10\/2026:<\/p>\n\n\n\n

Categor\u00eda<\/th>Tarifa de Meta (Brasil)<\/th><\/tr><\/thead>
Marketing<\/td>R$ 0,3217 por mensaje entregado<\/td><\/tr>
Utilidad<\/td>R$ 0,0350<\/td><\/tr>
Autenticaci\u00f3n<\/td>R$ 0,0350<\/td><\/tr>
Servicio<\/td>R$ 0,0350, despu\u00e9s de la franquicia de 1.000 al mes por n\u00famero<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

Para otros pa\u00edses, usa las tablas de la p\u00e1gina de precios<\/a> de Meta. Desde octubre de 2026, las plantillas de utilidad enviadas dentro de la ventana de atenci\u00f3n tambi\u00e9n se cobran. Expl\u00edcaselo al cliente antes de la primera factura. El art\u00edculo sobre mensajes de utilidad dentro de la ventana<\/a> tiene los detalles.<\/p>\n\n\n\n

Plantillas por cliente<\/h2>\n\n\n\n

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\u00e1s clientes. El trabajo de la agencia es mantener un est\u00e1ndar para no perderse entre decenas de cuentas.<\/p>\n\n\n\n

Una convenci\u00f3n que funciona:<\/p>\n\n\n\n

Parte del nombre<\/th>Ejemplo<\/th>Para qu\u00e9<\/th><\/tr><\/thead>
Finalidad<\/td>pedido_confirmado<\/code><\/td>Saber qu\u00e9 hace la plantilla<\/td><\/tr>
Variante<\/td>_v2<\/code><\/td>Cambiar el texto sin borrar el historial<\/td><\/tr>
Idioma (en el campo language<\/code>)<\/td>es_MX<\/code><\/td>Tener versiones por idioma con el mismo nombre<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

Mant\u00e9n una biblioteca de textos aprobados por sector. Los modelos de plantilla por sector<\/a> sirven de punto de partida. Antes de crear, revisa la categor\u00eda: el contenido promocional es marketing, aunque parezca un aviso. La gu\u00eda c\u00f3mo clasifica Meta tu plantilla<\/a> explica los criterios.<\/p>\n\n\n\n

En Vectalk, la creaci\u00f3n de plantillas usa el token de la instancia del cliente, y la cuenta de mensajes se resuelve a partir del token:<\/p>\n\n\n\n

curl -X POST https:\/\/apis.vectalk.com.br\/api\/templates \\\n  -H \"Authorization: Bearer TOKEN_INSTANCIA_CLIENTE_A\" \\\n  -H \"Content-Type: application\/json\" \\\n  -d '{\n    \"name\": \"pedido_confirmado_v2\",\n    \"language\": \"es_MX\",\n    \"category\": \"UTILITY\",\n    \"components\": [\n      { \"type\": \"BODY\", \"text\": \"Hola {{1}}, tu pedido #{{2}} fue confirmado.\",\n        \"example\": { \"body_text\": [[\"Ana\", \"4821\"]] } }\n    ]\n  }'<\/code><\/pre>\n\n\n\n
Webhooks y enrutamiento: una integraci\u00f3n, varios clientes<\/h2>\n\n\n\n
Cada evento de la Cloud API llega con el phone_number_id<\/code> en entry[].changes[].value.metadata<\/code>. As\u00ed sabe la agencia de qu\u00e9 cliente es el mensaje. Un enrutador m\u00ednimo en Node.js, con el mapa de clientes en el c\u00f3digo (en producci\u00f3n, en la base de datos):<\/p>\n\n\n\n
const CLIENTES = {\n  '1098765432': { nombre: 'clinica-ejemplo', destino: 'https:\/\/crm.agencia.com\/clinica' },\n  '2034567891': { nombre: 'tienda-ejemplo', destino: 'https:\/\/crm.agencia.com\/tienda' },\n};\n\nexport async function enrutar(evento) {\n  for (const entry of evento.entry ?? []) {\n    for (const change of entry.changes ?? []) {\n      const id = change.value?.metadata?.phone_number_id;\n      const cliente = CLIENTES[id];\n      if (!cliente) {\n        console.warn('phone_number_id sin cliente', id);\n        continue;\n      }\n      await fetch(cliente.destino, {\n        method: 'POST',\n        headers: { 'Content-Type': 'application\/json' },\n        body: JSON.stringify(change.value),\n      });\n    }\n  }\n}<\/code><\/pre>\n\n\n\n
Si integras directo con Meta, valida la firma X-Hub-Signature-256<\/code> antes de enrutar; el paso a paso est\u00e1 en c\u00f3mo validar la firma del webhook<\/a>.<\/p>\n\n\n\n
En Vectalk registras varias URL por instancia con POST \/api\/webhooks<\/code> (por ejemplo, el CRM del cliente y el monitoreo de la agencia), y todas reciben el mismo evento.<\/p>\n\n\n\n
Reportes por cliente<\/h2>\n\n\n\n
Separa por cliente y por mes: mensajes enviados, entregados, le\u00eddos y fallidos; env\u00edos por categor\u00eda (lo que define el costo); errores recurrentes, como bajas de marketing; y tiempo de respuesta, si la agencia opera la atenci\u00f3n. El costo estimado es la suma de entregados por categor\u00eda por la tarifa. Para m\u00e9tricas de atenci\u00f3n, consulta m\u00e9tricas de atenci\u00f3n en WhatsApp<\/a>.<\/p>\n\n\n\n
En Vectalk, GET \/api\/messages<\/code> acepta filtros de periodo, estado y direcci\u00f3n. Con un token de instancia, la consulta ya queda limitada a ese cliente:<\/p>\n\n\n\n
curl \"https:\/\/apis.vectalk.com.br\/api\/messages?from=2026-10-01&to=2026-10-31&status=failed&direction=outbound\" \\\n  -H \"Authorization: Bearer TOKEN_INSTANCIA_CLIENTE_A\"<\/code><\/pre>\n\n\n\n
Checklist para dar de alta a un cliente nuevo<\/h2>\n\n\n\n
    \n
  1. Portafolio propio del cliente, con \u00e9l como administrador, y verificaci\u00f3n iniciada.<\/li>\n\n\n
  2. N\u00famero definido (nuevo o en coexistencia) y nombre visible con la marca del cliente.<\/li>\n\n\n
  3. Cobro por escrito: qui\u00e9n le paga a Meta y c\u00f3mo se traslada el uso.<\/li>\n\n\n
  4. Opt-in de los contactos documentado por el cliente.<\/li>\n\n\n
  5. Plantillas aprobadas, webhook probado con un mensaje real y reporte mensual acordado.<\/li>\n\n<\/ol>\n\n\n\n
    C\u00f3mo hacerlo con Vectalk<\/h2>\n\n\n\n
    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:<\/p>\n\n\n\n