💬

Integración Zalo

Conecta OpenClaw a Zalo y haz que tu asistente de IA responda a los mensajes instantáneamente.

Resumen

✓ Prerrequisitos: Node.js 22+, OpenClaw instalado
✓ Configuración: Añadir sección Zalo a openclaw.json
✓ Tiempo: ~10 minutos
✓ Requiere: Cuenta Zalo + OA (Cuenta Oficial)

Prerrequisitos

1.

OpenClaw instalado

Sigue la guía de instalación si aún no lo has hecho.
2.

Cuenta Oficial de Zalo (OA)

Necesitas crear una Cuenta Oficial en oa.zalo.me.
3.

Credenciales de API de Zalo

Obtén tu ID de OA y clave API desde el panel de Zalo OA.

Pasos de Configuración

Paso 1: Crear Cuenta Oficial de Zalo

Si aún no tienes una OA:

Visita oa.zalo.me
Regístrate para una Cuenta Oficial (sigue el asistente)
Verifica tu cuenta
Obtén tu ID de OA desde el panel

Paso 2: Configurar openclaw.json

Añade la configuración de Zalo a tu archivo openclaw.json:

{
  "channels": {
    "zalo": {
      "enabled": true,
      "oaId": "tu_oa_id",
      "apiKey": "tu_api_key",
      "allowFrom": ["*"]
    }
  }
}

Paso 3: Iniciar OpenClaw

Inicia OpenClaw con Zalo habilitado:

openclaw start

El bot se conectará a Zalo y estará listo para recibir mensajes.

Paso 4: Probar tu Asistente de IA

Abre Zalo y busca tu Cuenta Oficial:

Abre la app de Zalo
Busca el nombre de tu OA
Envía un mensaje para iniciar una conversación

🎉 ¡Conectado! Tu asistente de IA para Zalo está listo.

Configuración Avanzada

Permitir Usuarios Específicos

Restringe quién puede interactuar con tu asistente de IA:

{
  "channels": {
    "zalo": {
      "enabled": true,
      "oaId": "tu_oa_id",
      "apiKey": "tu_api_key",
      "allowFrom": ["user_id_1", "user_id_2"]
    }
  }
}

Configuración de Webhook

Para funciones avanzadas, configura webhook en el panel de Zalo OA:

Ve al panel de OA → Configuración Avanzada → Webhook
Establece la URL del webhook a tu servidor OpenClaw
Habilita los eventos que deseas recibir

Solución de Problemas

¿Clave API inválida?

Verifica tu clave API en el panel de Zalo OA. Asegúrate de que la API esté habilitada para tu cuenta.

¿Mensajes no recibidos?

Verifica que tu openclaw.json tenga "enabled": true para el canal Zalo y revisa los logs.

¿OA no encontrada?

Asegúrate de que tu Cuenta Oficial esté verificada y activa. Las OAs nuevas pueden necesitar aprobación primero.