Token导航 LogoToken导航

Agent Skill · 开发

whatsapp-business-latam(WhatsApp business latam 开发)

whatsapp-business-latam 用于补充开发相关能力,适合在 OpenClaw 中需要让 Agent 承接开发相关任务时使用。可结合来源仓库、安装命令和原始 README 继续核验具体用法。安装前建议确认权限范围、维护状态,以及是否会触发联网、命令执行或文件读写。

whatsapp-business-latam 是开发类 Agent Skill,可用宿主为 OpenClaw,通过ClawHub获取,权限为接触敏感数据;许可证为 MIT-0,第三方扫描已通过,按安装量在开发类的 21,746 个 Skill 里排第 10,513。

总安装 2,210周安装 93GitHub Stars 1下载 774核验 2026-05-01

安装说明

本站只整理中文说明,不托管安装包,也不代用户安装。
GitHub
许可证
MIT-0
版本
1.0.0

安装方式

通过对话安装

复制提示词发给支持本地命令或 Skills 的 AI 助手,先确认命令和权限,再让它执行。

请帮我安装这个 Agent Skill:whatsapp-business-latam(WhatsApp business latam 开发)
来源仓库:https://github.com/centriqs/whatsapp-business-latam
安装命令:
openclaw skills install whatsapp-business-latam
安装前请先检查当前环境是否支持对应 CLI,并向我确认将要执行的命令、安装目录、联网范围和文件读写权限;确认后再执行。

命令行安装

复制命令到本机终端执行。该命令会通过 OpenClaw 从第三方来源获取 Skill;本站只展示命令,不托管安装包,也不自动执行。

ClawHubOpenClaw
openclaw skills install whatsapp-business-latam

这个 Skill 是做什么的

开发类 Skill 面向写代码、改代码和排查问题,一般会读写仓库文件,部分还会执行构建或测试命令。

用于补充开发相关能力,支持拉美地区 WhatsApp Business API 配置。适用于阿根廷和拉美 PyME 企业的官方元 API 集成需求。激活常用功能如 WhatsApp Business 和 WA API 的完整配置。安装前需确认区域合规性和 API 访问权限。建议结合本地法规要求评估使用可行性。

whatsapp-business-latam 属于开发类 Skill,可作为该场景下的辅助能力补充。

上手步骤

4 步
  1. 1

    确认自己的宿主工具

    公开资料标注支持 OpenClaw;先确认自己用的是其中之一,再按对应工具的 Skills 目录放置。

  2. 2

    拿到安装命令

    可以直接复制的命令是 openclaw skills install whatsapp-business-latam;命令里的占位符换成自己的路径或密钥再执行。

  3. 3

    安装后重启宿主

    命令执行完要完全退出宿主工具再打开,让新装的 Skill 被重新扫描到,否则列表里可能看不到。

  4. 4

    按最小权限试用

    它需要接触敏感数据,先在测试目录或测试账号里跑,确认没问题再放到正式项目。

常见问题

6 条

whatsapp-business-latam 怎么安装?

在终端执行 openclaw skills install whatsapp-business-latam。装完完全退出宿主工具再打开,让它重新扫描本地 Skill。

whatsapp-business-latam 支持哪些 AI 工具?

公开资料标注支持 OpenClaw。其他工具只要能读取本地 Skill 目录,一般也能手动放进去,但要自己确认触发方式是否一致。

whatsapp-business-latam 需要什么权限?

权限级别是接触敏感数据。该 Skill 可能接触密钥、Token、环境变量或敏感配置,应进入高风险复核队列,默认不自动发布。

whatsapp-business-latam 是免费的吗?

来源标注的许可证是 MIT-0。本站不代收任何费用,也不托管安装包;能否商用、要不要署名,以许可证原文为准。

whatsapp-business-latam 用的人多吗?

公开数据是累计安装 2,210 次,近一周安装 93 次,下载 774 次,GitHub 1 星。这些数字来自第三方目录统计,只能当作热度参考,不代表质量或安全性。

whatsapp-business-latam 安全吗?

第三方扫描结果为通过,但这只覆盖已知的静态检查项,不能替代自己读一遍源码和安装命令。

值得选的地方和要先想清楚的地方

值得选的地方

  • 专注 OpenClaw 一种宿主,触发方式和使用习惯不用来回切换。
  • 许可证明确为 MIT-0,商用和分发边界好判断。
  • 第三方扫描已通过,常见的高风险行为没有命中。

先想清楚的地方

  • 需要接触敏感数据,装到常用环境前要先评估影响面。
  • 第三方目录整理,版本更新和行为细节以来源仓库为准。

适不适合你

更适合

  • 已经在用 OpenClaw,想直接扩展它能力的人。
  • 需要处理开发类任务、又不想每次都手写提示词的人。
  • 需要许可证清楚、并且有第三方扫描结果的团队项目。

不太适合

  • 环境里有大量密钥、凭证,不方便给第三方 Skill 读取的人。
  • 需要厂商级技术支持和 SLA 的生产系统。

开发类 Skill 对比

6 个同类
Skill总安装GitHub 星权限许可证扫描
skill-vetter

技能审查员 · OpenClaw

8,779,018986操作浏览器MIT-0通过
ontology

本体论 · OpenClaw

6,636,960576只读MIT-0通过
entra-app-registration

内部应用程序注册 · Codex、Claude

6,631,872764接触敏感数据未明确通过
entra-app-registration

内部应用程序注册 · Codex、Claude

3,757,680201接触敏感数据未明确通过
nano-banana-pro

纳米香蕉专业版 · OpenClaw

3,526,898364接触敏感数据MIT-0有提醒
whatsapp-business-latam

WhatsApp business latam 开发 · 本页

2,2101接触敏感数据MIT-0通过

按安装量取同分类前几名;数字来自第三方目录统计,只作热度参考,不代表质量结论。

SKILL.md 原文

name
whatsapp-business-latam
description
>
version
1.0.0
metadata
openclaw
emoji
💬
requires
bins
env
[]
always
false
homepage
https://centriqs.io

WhatsApp Business LATAM

Guía de configuración completa de la WhatsApp Business API oficial de Meta para PyMEs en Argentina y LATAM. Integración con OpenClaw, templates HSM en español, compliance, y guía anti-ban.

⚠️ Solo API oficial. Este skill cubre exclusivamente la API oficial de Meta (WhatsApp Business Platform). Nunca usar librerías no oficiales como Baileys, whatsapp-web.js, WPPConnect, o similares en producción — violan los Términos de Servicio de WhatsApp y resultan en baneo permanente del número. Ver sección "Anti-ban" al final.

Comandos

wa setup                        # Guía de setup paso a paso desde cero
wa setup <paso>                 # Paso específico (ej: "wa setup meta-business")
wa template <tipo>              # Template HSM listo para copiar (ver lista abajo)
wa templates                    # Lista todos los templates disponibles
wa checklist                    # Checklist anti-ban completo
wa config                       # Muestra el bloque de config para openclaw.json
wa webhook                      # Instrucciones de configuración del webhook
wa test                         # Cómo enviar un mensaje de prueba con curl
wa compliance                   # Reglas de compliance Meta para no perder la cuenta
wa costos                       # Estimación de costos de la API para PyMEs argentinas
wa ayuda                        # Este menú

Workspace

~/centriqs/whatsapp/
├── config.md           # Tokens, números, IDs (ver nota de seguridad)
├── templates/          # Templates HSM personalizados del usuario
│   └── aprobados.md    # Templates aprobados por Meta con sus IDs
└── logs/               # Log de envíos (opcional)
🔒 Seguridad: ~/centriqs/whatsapp/config.md puede contener tokens de acceso. Asegurar que el directorio tenga permisos chmod 700 ~/centriqs/whatsapp/. Nunca compartir el contenido de este archivo en canales públicos o grupos.

config.md — Completar durante el setup

# Configuración WhatsApp Business API

## Credenciales (completar después del setup)
phone_number_id: ""          # ID del número en Meta Business Manager
whatsapp_business_account_id: ""  # WABA ID
access_token: ""             # Token de acceso permanente (System User)
webhook_verify_token: ""     # Token de verificación del webhook (elegido por vos)
app_id: ""                   # App ID en Meta for Developers

## Número
numero_whatsapp: ""          # Formato: +5491112345678
nombre_display: ""           # Nombre que verán los contactos

## Estado
cuenta_verificada: false     # true cuando Meta aprueba la cuenta de negocio
templates_aprobados: 0       # Cantidad de templates aprobados

Setup completo — paso a paso

Paso 1: Cuenta de Facebook Business (Meta Business Suite)

Prerequisito obligatorio. Si ya tenés una cuenta empresarial de Facebook/Meta, saltar al paso 2.

  1. Ir a business.facebook.com
  2. Crear cuenta de negocio con:

- Nombre real de la empresa (no cambiar después — afecta la verificación) - Email empresarial (usar hola@tudominio.com, no Gmail personal) - País: Argentina (o el país del negocio)

  1. Completar perfil de negocio: dirección, sitio web, categoría
⚠️ Usar datos reales del negocio. Las cuentas con datos falsos o inconsistentes son marcadas como spam por los algoritmos de Meta y pueden ser suspendidas.

Paso 2: Meta for Developers — Crear la App

  1. Ir a developers.facebook.com
  2. Click en "My Apps" → "Create App"
  3. Seleccionar tipo: "Business"
  4. Completar:

- App name: [NombreEmpresa] WA Bot (ej: Centriqs WA Bot) - Contact email: email empresarial - Business account: seleccionar la cuenta del Paso 1

  1. En el dashboard de la app, buscar "WhatsApp" y click en "Set up"

Guardar en config.md: el App ID que aparece en el dashboard de la app.


Paso 3: WhatsApp Business Account (WABA) y número

  1. Dentro de la app en Meta for Developers, ir a WhatsApp → Getting Started
  2. Meta provee un número de prueba gratuito para testing (solo para 5 contactos)
  3. Para producción: agregar un número real dedicado

- El número no puede estar registrado en ninguna app de WhatsApp (ni personal ni Business) - Si el número ya tiene WhatsApp, primero borrarlo de WhatsApp en el teléfono - Puede ser: línea móvil, línea fija con capacidad de recibir SMS/llamadas, VoIP

  1. Proceso de verificación del número:

- Ingresar el número en formato internacional: +5491112345678 - Recibir código por SMS o llamada - Ingresar código → número verificado

Guardar en config.md:

  • phone_number_id (aparece en la sección del número)
  • whatsapp_business_account_id (WABA ID)

Paso 4: Token de acceso permanente (System User)

El token temporal de prueba expira en 24 horas. Para producción, crear un System User con token permanente:

  1. Ir a Meta Business Suite → Configuración del negocio → Usuarios → Usuarios del sistema
  2. Click "Agregar" → tipo: "Admin"
  3. Asignar activos: seleccionar la app de WhatsApp creada en el Paso 2
  4. Generar token:

- Click en el System User creado → "Generar nuevo token" - App: seleccionar tu app - Permisos mínimos necesarios: - whatsapp_business_messaging - whatsapp_business_management - Expiración: "Nunca"

  1. Copiar y guardar el token de inmediato (no se puede recuperar después)

Guardar en config.md: access_token

🔒 Este token tiene acceso completo al número de WhatsApp. Tratar como una contraseña. Rotarlo si se sospecha que fue comprometido desde Meta Business Suite.

Paso 5: Webhook — recibir mensajes entrantes

El webhook es la URL donde Meta envía los mensajes que recibe tu número. OpenClaw necesita exponerse como servidor para recibirlos.

Opción A — Vercel (recomendada para Centriqs):

Crear un endpoint en tu proyecto de Vercel en centriqs.io/api/whatsapp:

// api/whatsapp.js (Next.js / Vercel serverless function)
export default function handler(req, res) {
  if (req.method === 'GET') {
    // Verificación inicial del webhook por Meta
    const mode = req.query['hub.mode'];
    const token = req.query['hub.verify_token'];
    const challenge = req.query['hub.challenge'];

    if (mode === 'subscribe' && token === process.env.WEBHOOK_VERIFY_TOKEN) {
      return res.status(200).send(challenge);
    }
    return res.status(403).end();
  }

  if (req.method === 'POST') {
    // Reenviar el payload a OpenClaw (webhook local o túnel)
    // Implementar según arquitectura: ngrok en dev, VPS en producción
    console.log('Mensaje entrante:', JSON.stringify(req.body, null, 2));
    return res.status(200).json({ status: 'ok' });
  }
}

Variable de entorno en Vercel: WEBHOOK_VERIFY_TOKEN=<tu_token_elegido>

Opción B — VPS del cliente (producción):

Para clientes en managed services, el webhook apunta al VPS del cliente. OpenClaw escucha en el puerto configurado (por defecto 3000 o el que definas).

Configurar el webhook en Meta:

  1. En Meta for Developers → tu App → WhatsApp → Configuration
  2. Webhook URL: https://centriqs.io/api/whatsapp (o la URL de tu VPS)
  3. Verify Token: el valor de webhook_verify_token en tu config.md
  4. Click "Verify and Save"
  5. Suscribir a los campos: messages, message_deliveries, message_reads

Paso 6: Integración con openclaw.json

Agregar el canal de WhatsApp en la configuración de OpenClaw:

// ~/.openclaw/openclaw.json — sección "channels"
{
  "channels": {
    "whatsapp": {
      "enabled": true,
      "provider": "meta-cloud-api",
      "phoneNumberId": "<phone_number_id_de_config.md>",
      "accessToken": "<access_token_de_config.md>",
      "webhookVerifyToken": "<webhook_verify_token_de_config.md>",
      "webhookPath": "/webhook/whatsapp",
      "wabaId": "<whatsapp_business_account_id_de_config.md>"
    }
  }
}
⚠️ No hardcodear tokens directamente en openclaw.json si el archivo es accesible desde el repositorio. Usar variables de entorno y referenciarlas con ${VAR_NAME}.

Paso 7: Verificación de la cuenta de negocio (Meta Business Verification)

Para desbloquear límites de mensajes y poder enviar mensajes de plantilla a cualquier número (no solo a los 5 de prueba), es necesario verificar la empresa ante Meta.

  1. Ir a Meta Business Suite → Configuración → Verificación del negocio
  2. Seleccionar país: Argentina
  3. Documentos necesarios (uno de los siguientes):

- DNI/CUIT + constancia de inscripción AFIP (monotributistas y autónomos) - Contrato de sociedad + inscripción en IGJ (SRL, SA) - Extracto bancario a nombre de la empresa (últimos 3 meses)

  1. La verificación tarda 2-5 días hábiles
  2. Una vez verificada: límite inicial de 1,000 conversaciones de negocio por día
La verificación desbloquea también la posibilidad de usar el nombre de display personalizado (en vez del número de teléfono) en los chats.

Templates HSM — Listos para usar

Los HSM (Highly Structured Messages) son plantillas pre-aprobadas por Meta para enviar mensajes fuera de la ventana de 24 horas. Son obligatorios para iniciar conversaciones o para mensajes automatizados (recordatorios, alertas, notificaciones).

Cómo enviar un template aprobado:

curl -X POST \
  "https://graph.facebook.com/v23.0/<PHONE_NUMBER_ID>/messages" \
  -H "Authorization: Bearer <ACCESS_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
    "messaging_product": "whatsapp",
    "to": "5491112345678",
    "type": "template",
    "template": {
      "name": "<NOMBRE_DEL_TEMPLATE>",
      "language": { "code": "es_AR" },
      "components": [
        {
          "type": "body",
          "parameters": [
            { "type": "text", "text": "<VALOR_VARIABLE_1>" },
            { "type": "text", "text": "<VALOR_VARIABLE_2>" }
          ]
        }
      ]
    }
  }'

TEMPLATE 1 — Confirmación de turno

Nombre sugerido: confirmacion_turno_v1 Categoría Meta: UTILITY Idioma: es_AR

Hola {{1}}, tu turno está confirmado para el {{2}} a las {{3}} hs.

Dirección: {{4}}

Si necesitás reprogramar, respondé este mensaje o llamanos al {{5}}.

— {{6}}

Variables:

  1. Nombre del cliente
  2. Fecha (DD/MM/AAAA)
  3. Hora (HH:MM)
  4. Dirección del negocio
  5. Teléfono de contacto
  6. Nombre del negocio

Ejemplo de uso real:

"Hola María, tu turno está confirmado para el 15/04/2026 a las 10:30 hs. Dirección: Av. Corrientes 1234, CABA. Si necesitás reprogramar, respondé este mensaje o llamanos al 11-4444-5555. — Estudio Pérez & Asociados"

TEMPLATE 2 — Recordatorio de turno (24hs antes)

Nombre sugerido: recordatorio_turno_24hs_v1 Categoría Meta: UTILITY Idioma: es_AR

Recordatorio: {{1}}, mañana {{2}} tenés turno a las {{3}} hs en {{4}}.

Confirmá respondiendo SÍ o comunicate si necesitás cancelar.

— {{5}}

Variables:

  1. Nombre del cliente
  2. Fecha (ej: "martes 14/04")
  3. Hora
  4. Nombre del lugar/consultorio/estudio
  5. Nombre del negocio

TEMPLATE 3 — Recordatorio de pago pendiente

Nombre sugerido: recordatorio_pago_pendiente_v1 Categoría Meta: UTILITY Idioma: es_AR

Hola {{1}}, te recordamos que tenés un pago pendiente por ${{2}} con vencimiento el {{3}}.

Podés abonar por transferencia al CBU {{4}} a nombre de {{5}}, o respondé este mensaje para coordinar.

— {{6}}

Variables:

  1. Nombre del cliente
  2. Monto (sin símbolo de moneda en la variable — el $ va en el template)
  3. Fecha de vencimiento (DD/MM/AAAA)
  4. CBU de la empresa
  5. Titular del CBU
  6. Nombre del negocio

TEMPLATE 4 — Alerta de vencimiento AFIP/ARCA

Nombre sugerido: alerta_vencimiento_arca_v1 Categoría Meta: UTILITY Idioma: es_AR

📋 Recordatorio fiscal: {{1}}, el {{2}} vence {{3}}.

{{4}}

Consultá con tu contador si necesitás asistencia. Respondé este mensaje para más información.

— {{5}}

Variables:

  1. Nombre del cliente o empresa
  2. Fecha de vencimiento (DD/MM/AAAA)
  3. Nombre de la obligación (ej: "IVA período marzo 2026")
  4. Nota adicional (ej: "CUIT terminados en 0 y 1" o "Todos los contribuyentes")
  5. Nombre del estudio/agente que envía

Uso típico: estudios contables que quieren recordar a sus clientes los vencimientos del mes sin llamar uno por uno.


TEMPLATE 5 — Notificación de entrega / pedido listo

Nombre sugerido: pedido_listo_v1 Categoría Meta: UTILITY Idioma: es_AR

Hola {{1}}, tu pedido #{{2}} está listo para {{3}}.

{{4}}

Ante cualquier consulta respondé este mensaje.

— {{5}}

Variables:

  1. Nombre del cliente
  2. Número de pedido o referencia
  3. retiro en tienda / envío a domicilio / descarga disponible
  4. Instrucciones adicionales (ej: dirección, link de descarga, código de retiro)
  5. Nombre del negocio

TEMPLATE 6 — Bienvenida / primer contacto

Nombre sugerido: bienvenida_v1 Categoría Meta: MARKETING Idioma: es_AR

¡Hola {{1}}! Bienvenido/a a {{2}} 👋

Soy el asistente virtual. Puedo ayudarte con:
• {{3}}
• {{4}}
• {{5}}

¿En qué puedo ayudarte hoy?

Variables:

  1. Nombre del contacto (si está disponible)
  2. Nombre del negocio

3, 4, 5. Servicios principales (ej: "Consultas sobre turnos", "Estado de pedidos", "Información de precios")

ℹ️ Los templates de categoría MARKETING tienen costo por conversación más alto que los de UTILITY. Usar solo cuando es el primer contacto o para campañas activas.

Cómo enviar templates desde OpenClaw

El agente puede ejecutar el envío de templates usando el comando curl (declarado en requires.bins). Ejemplo de función reutilizable:

# Función de envío de template WhatsApp
# Uso: wa_send_template <numero> <template_name> <var1> <var2> ...

wa_send_template() {
  local numero="$1"
  local template_name="$2"
  shift 2
  local params=""

  for var in "$@"; do
    params="${params}{\"type\":\"text\",\"text\":\"${var}\"},"
  done
  params="${params%,}"  # Quitar última coma

  curl -s -X POST \
    "https://graph.facebook.com/v23.0/${PHONE_NUMBER_ID}/messages" \
    -H "Authorization: Bearer ${WA_ACCESS_TOKEN}" \
    -H "Content-Type: application/json" \
    -d "{
      \"messaging_product\": \"whatsapp\",
      \"to\": \"${numero}\",
      \"type\": \"template\",
      \"template\": {
        \"name\": \"${template_name}\",
        \"language\": {\"code\": \"es_AR\"},
        \"components\": [{
          \"type\": \"body\",
          \"parameters\": [${params}]
        }]
      }
    }"
}

Variables de entorno requeridas (inyectar en openclaw.json bajo skills.entries):

{
  "skills": {
    "entries": {
      "whatsapp-business-latam": {
        "env": {
          "PHONE_NUMBER_ID": "<phone_number_id>",
          "WA_ACCESS_TOKEN": "<access_token>"
        }
      }
    }
  }
}

Compliance — Reglas para no perder la cuenta

Ventana de servicio de 24 horas (Customer Service Window)

Cuando un usuario te escribe un mensaje, se abre automáticamente una Customer Service Window (CSW) de 24 horas. Cada mensaje que el usuario envía reinicia el contador.

Qué podés hacer dentro de la CSW (todo gratis):

  • Enviar cualquier cantidad de mensajes de texto libre
  • Enviar imágenes, documentos, audios, ubicaciones
  • Enviar templates de utility (sin costo, desde julio 2025)

Qué NO podés hacer dentro de la CSW:

  • Enviar templates de marketing o autenticación (siempre tienen costo)

Fuera de la CSW (más de 24hs desde el último mensaje del usuario):

  • Solo podés enviar templates aprobados
  • Cada template delivered se cobra según su categoría (ver sección Costos)

Regla práctica para PyMEs: mantener la conversación activa es gratis. Si un cliente escribe una consulta, el agente puede responder todo lo necesario sin costo, incluso enviar confirmaciones o recordatorios con templates de utility — siempre que sea dentro de las 24hs desde el último mensaje del cliente.

Opt-in obligatorio

Meta exige que los contactos hayan dado consentimiento explícito para recibir mensajes de WhatsApp de tu empresa antes de que les envíes el primer template.

Formas válidas de opt-in:

  • Formulario web con checkbox específico para WhatsApp
  • Mensaje de confirmación por SMS previo al primer WA
  • Confirmación verbal documentada (en el momento del turno, por ejemplo)

Lo que NO es opt-in válido:

  • Tener el número de teléfono del cliente
  • Que el cliente te haya comprado algo
  • Un contrato genérico de servicios
Guardar evidencia del opt-in por cliente. Si Meta audita tu cuenta y no podés demostrar el consentimiento, el número puede ser baneado.

Rate limits — Messaging Tiers

Meta limita la cantidad de usuarios únicos a los que podés iniciar conversaciones por día (los mensajes entrantes y respuestas dentro de CSW no cuentan contra el límite).

TierUsuarios únicos / 24hs
Sin verificar250
Tier 1 (cuenta verificada)1,000
Tier 210,000
Tier 3100,000
Tier 4Ilimitado

Cómo se sube de tier:

  • Mantener quality rating en Verde durante 7 días consecutivos
  • Enviar al menos el 50% del volumen del tier actual durante esos 7 días
  • El upgrade es automático (no requiere solicitud)

Cómo se baja de tier:

  • Quality rating en Rojo durante 7 días → bajás un tier
  • Quality rating en Rojo persistente → suspensión del número

Quality Rating

Meta mide la calidad de tu cuenta según:

  • Tasa de bloqueos de contactos
  • Reportes de spam
  • Tasa de respuesta a mensajes entrantes
  • Relevancia de los templates enviados

Si cae a "Amarillo": recibís una advertencia. Reducir volumen de envíos inmediatamente. Si cae a "Rojo": el número queda en pausa. Puede resultar en baneo si no mejora.


Free Entry Points — la ventana de 72 horas

Meta abre una ventana especial de 72 horas de mensajes completamente gratis cuando el usuario entra a tu WhatsApp a través de:

  • Click-to-WhatsApp Ads (anuncios en Facebook/Instagram que abren el chat)
  • Facebook Page CTA button ("Enviar mensaje" en tu página de Facebook)
  • Anuncios de WhatsApp Flow

Durante esas 72 horas:

  • Podés enviar cualquier cantidad de mensajes de cualquier categoría (incluido marketing)
  • Sin costo para ninguno de ellos
  • El contador se reinicia con cada nuevo mensaje del usuario dentro de la ventana

Por qué es importante para PyMEs argentinas:

Si hacés campañas pagas en Meta Ads con CTA a WhatsApp, el costo de los mensajes posteriores queda incluido en el costo del ad. Esto cambia la matemática del customer acquisition: lo que pagás es solo el ad, no los mensajes de follow-up.

Estrategia recomendada:

  1. Correr campaña de Click-to-WhatsApp Ads con presupuesto definido
  2. Responder rápido (ventana de 72hs empieza con el click)
  3. Cerrar la venta o agendar reunión dentro de las 72hs
  4. A partir de la 73ª hora, si necesitás re-engagement, usar utility templates (paid)

Checklist anti-ban

Antes de enviar el primer mensaje de producción, verificar que:

[ ] El número usado es EXCLUSIVO para WhatsApp Business API
    (no está ni estuvo en la app de WhatsApp personal o Business App)

[ ] La cuenta de Meta Business está verificada con documentación real

[ ] Todos los contactos dieron opt-in explícito antes del primer envío

[ ] Los templates fueron aprobados por Meta antes de enviarlos
    (no enviar templates "pendientes de revisión")

[ ] El nombre de display del número coincide con el nombre legal del negocio
    o una variación reconocible

[ ] No se está usando ninguna librería no oficial:
    ❌ Baileys
    ❌ whatsapp-web.js
    ❌ WPPConnect
    ❌ venom-bot
    ❌ Chat-API
    ✅ Meta Cloud API (graph.facebook.com)

[ ] El token de acceso es de un System User, no de una cuenta personal

[ ] Los mensajes tienen un propósito claro y valor para el receptor
    (no spam, no mensajes masivos sin segmentación)

[ ] El webhook responde con HTTP 200 en menos de 5 segundos
    (si Meta no recibe 200, reintenta y puede marcar la cuenta como problemática)

[ ] El número tiene habilitado el desvío de llamadas o puede recibir SMS
    (necesario para renovar la verificación del número si caduca)

Costos estimados para PyMEs argentinas

⚠️ Cambio importante — julio 2025: Meta migró de un modelo de pricing "per-conversation" (24hs) a un modelo per-message. Todo este skill está actualizado al nuevo modelo. Referencia oficial: business.whatsapp.com/products/platform-pricing

Qué es gratis en el modelo per-message (muy importante para PyMEs)

CategoríaCosto
Service messages (cualquier mensaje dentro de la Customer Service Window)GRATIS sin límite
Utility templates enviados dentro de la CSWGRATIS sin límite
Free Entry Points — usuarios que entran via Click-to-WhatsApp Ads o CTA de Facebook Page72hs de mensajes gratis (incluido marketing)

Esto es un cambio estructural: una PyME con tráfico entrante orgánico (clientes que inician la conversación) puede operar con costo casi nulo.

Qué se paga (modelo per-message, por template delivered)

CategoríaCuándo aplica
Utility templateEnviado fuera de la CSW (recordatorio proactivo sin conversación previa reciente)
Marketing templateCampañas, promociones, bienvenidas sin conversación previa
Authentication templateCódigos de verificación, OTPs, 2FA

Las tarifas exactas por país y categoría están en el sitio oficial de Meta. Meta ajusta precios periódicamente — no hardcodear valores en integraciones productivas.

Volume tiers (descuentos por volumen)

Desde julio 2025, Meta aplica tiered pricing para utility y authentication: cuanto más envíes, menor es el costo unitario. Los tiers se definen por mercado y se calculan mensualmente según el volumen acumulado del mes.

Estimación de costo mensual (escenarios reales)

Escenario A — Estudio contable con 50 clientes, solo recordatorios ARCA:

  • Clientes escriben consultas durante el mes (genera CSW): service messages gratis
  • ~50 recordatorios proactivos de vencimiento por mes (utility fuera de CSW)
  • Costo estimado: USD 1-3/mes (solo los utility fuera de CSW)

Escenario B — E-commerce chico con 500 pedidos/mes:

  • Cliente compra y recibe confirmación (dentro de la CSW si preguntó algo antes): gratis
  • Actualización de envío (utility, mayoría dentro de CSW): gratis
  • Recordatorio de carrito abandonado (marketing, fuera de CSW): paid
  • Costo estimado: USD 5-20/mes según mix

Escenario C — PyME con estrategia de CTWA Ads:

  • Leads llegan via Click-to-WhatsApp Ads → 72hs gratis para vender
  • Mensajes de seguimiento post-72hs: utility paid
  • Costo estimado: USD 10-30/mes (pero con ROI muy alto por cost-per-lead bajo)
Factor clave: el costo real depende de la proporción entre mensajes dentro y fuera de la CSW. Una PyME que fomenta que el cliente inicie la conversación (respondiendo rápido, usando CTWA Ads, mostrando el número en redes) paga muy poco.

Mensaje de respuesta libre (dentro de ventana de 24hs)

Cuando el usuario escribe al número, el agente puede responder con texto libre durante las siguientes 24 horas. Ejemplo de respuesta automática vía API:

curl -X POST \
  "https://graph.facebook.com/v23.0/${PHONE_NUMBER_ID}/messages" \
  -H "Authorization: Bearer ${WA_ACCESS_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
    "messaging_product": "whatsapp",
    "to": "5491112345678",
    "type": "text",
    "text": {
      "body": "¡Hola! Recibimos tu mensaje y te respondemos en breve. — Equipo Centriqs"
    }
  }'

Prueba de envío — verificar que todo funciona

Una vez completado el setup, enviar un mensaje de prueba:

# Reemplazar con tus valores reales
PHONE_NUMBER_ID="tu_phone_number_id"
ACCESS_TOKEN="tu_access_token"
NUMERO_DESTINO="549XXXXXXXXXX"  # Tu propio número para prueba

curl -X POST \
  "https://graph.facebook.com/v23.0/${PHONE_NUMBER_ID}/messages" \
  -H "Authorization: Bearer ${ACCESS_TOKEN}" \
  -H "Content-Type: application/json" \
  -d "{
    \"messaging_product\": \"whatsapp\",
    \"to\": \"${NUMERO_DESTINO}\",
    \"type\": \"text\",
    \"text\": {\"body\": \"Prueba de conexión exitosa — OpenClaw + WhatsApp Business API ✓\"}
  }"

Respuesta esperada:

{
  "messaging_product": "whatsapp",
  "contacts": [{"input": "549XXXXXXXXXX", "wa_id": "549XXXXXXXXXX"}],
  "messages": [{"id": "wamid.XXXXXXXXXX"}]
}

Si obtenés "error" en la respuesta, verificar: token válido, PHONE_NUMBER_ID correcto, número de destino en formato internacional sin + (ej: 5491112345678 no +5491112345678).


Privacidad y seguridad

  • El access_token de System User tiene acceso completo al número. Nunca incluirlo en

código que se suba a repositorios públicos (GitHub, GitLab, etc.).

  • Usar variables de entorno o el sistema de secrets de OpenClaw (skills.entries.*.env).
  • Los mensajes de los usuarios son datos personales sujetos a la Ley 25.326 de Argentina

(Protección de Datos Personales). No almacenar conversaciones sin consentimiento explícito.

  • El log de envíos en ~/centriqs/whatsapp/logs/ debe tener permisos restringidos

(chmod 600) si contiene nombres o números de clientes.

  • Ante una brecha de seguridad que exponga el token, rotarlo inmediatamente desde

Meta Business Suite → Usuarios del sistema → Generar nuevo token.


Related skills

SkillRelación
latam-timezone-briefingPuede disparar envíos de WhatsApp como canal de entrega del briefing
argentina-fiscal-calendarProvee los datos de vencimientos que el agente puede notificar por WhatsApp
whatsapp-business-latam-pro *(paid — ClawMart, próximamente)*Automatización avanzada: menú interactivo, respuestas con botones, flows, integración con Tiendanube y MercadoPago

*Desarrollado por Centriqs — Center of your operations* *MIT License — Libre uso, modificación y redistribución con atribución*

平台分布

OpenClaw

71.37%
按下载量换算552

安全审计

VirusTotal

通过

ClawScan

通过

Static analysis

通过

权限和风险

接触敏感数据

该 Skill 可能接触密钥、Token、环境变量或敏感配置,应进入高风险复核队列,默认不自动发布。

安装前确认

本站仅展示第三方公开信息,不托管安装包,不提供自动安装或运行环境。安装前应自行审查源码、依赖和命令行为。目前只有一个公开来源,建议同时核对源仓库。

继续浏览同类 Skills