Zalo es la app de mensajería dominante en Vietnam, y tu Official Account es la manera en que tus clientes te contactan ahí. Conecta una con OAuth y lee y responde conversaciones con la misma API de mensajes directos que usas para Instagram, WhatsApp y Telegram. Los mensajes entrantes llegan en tiempo real a través de webhooks.
Responder a una conversación de Zalo
1curl -X POST https://api.social-api.ai/v1/inbox/conversations/<conversation-id>/messages \
2 -H "Authorization: Bearer <your-api-key>" \
3 -H "Content-Type: application/json" \
4 -d '{
5 "account_id": "<zalo-account-id>",
6 "text": "Cam on ban! Your order shipped today."
7 }' | jq
8
9# Response (HTTP 201)
10{
11 "id": "eb1f2c9a4d...",
12 "platform": "zalo",
13 "conversation_id": "<conversation-id>",
14 "text": "Cam on ban! Your order shipped today.",
15 "created_at": "2026-08-23T10:24:00Z"
16}
Los mensajes entrantes llegan a la bandeja de entrada unificada vía webhooks; responder es un solo POST. El mismo endpoint y el mismo payload que ya usas para Instagram, WhatsApp y Telegram entregan una respuesta desde tu Zalo Official Account.
Recibe mensajes de clientes en tiempo real y responde a través del mismo endpoint de bandeja de entrada unificada que usas en todas las demás plataformas.
Crea, actualiza y elimina artículos y publicaciones de video de tu Zalo Official Account a través de la API de publicación unificada.
Los mensajes y eventos entrantes llegan como eventos de webhook en tiempo real, con la firma verificada al momento de recibirlos.
el Open API oficial de Zalo Official Account
Registra una app de Zalo, arma a mano el flujo de autorización PKCE y verifica el dominio de tu callback antes de que funcione el primer intercambio de tokens.
Con SocialAPI.ai
Haz clic en conectar desde el dashboard. PKCE, el callback y el redirect con dominio verificado quedan resueltos de nuestro lado.
el Open API oficial de Zalo Official Account
Los access tokens duran unas 25 horas y el refresh token es de un solo uso, así que rota en cada renovación. Si pierdes esa rotación, la cuenta queda desconectada.
Con SocialAPI.ai
Los tokens se renuevan antes de expirar y el par rotado se guarda por ti. Nunca manejas un token de Zalo.
el Open API oficial de Zalo Official Account
La creación de artículos es asíncrona. Envías un token y luego consultas un endpoint de verificación que sigue devolviendo un código de procesamiento hasta que el artículo se publica.
Con SocialAPI.ai
Una sola llamada a la API de publicación. El sondeo ocurre dentro del conector y recibes la publicación ya terminada.
el Open API oficial de Zalo Official Account
Una integración solo para Vietnam que mantienes por separado de cualquier otra API de mensajería.
Con SocialAPI.ai
Los mismos endpoints /v1/inbox cubren Zalo y otras diez plataformas, con un solo esquema para conversaciones y mensajes.
En Zalo no hay comentarios, reseñas ni menciones. Zalo no expone ninguna API pública para ellos, así que esas partes de la API unificada no aplican a esta plataforma.
Enviar un mensaje requiere que el cliente haya interactuado con tu Official Account en los últimos 7 días. Fuera de esa ventana Zalo rechaza el envío y la API devuelve un 422.
La creación de artículos es asíncrona. Zalo devuelve un código de procesamiento hasta que el artículo se publica, así que la publicación se completa tras un breve sondeo y no de forma instantánea.
Una Official Account por conexión. Un token de Zalo da acceso a una sola OA, así que conecta cada Official Account por separado.
Cuando conectas una Official Account, SocialAPI.ai registra el webhook de Zalo y verifica la firma de cada evento antes de aceptarlo. Los mensajes de tus clientes se ingieren a medida que llegan y aparecen en la bandeja de entrada unificada con el mismo esquema de conversación y mensaje utilizado en todas las plataformas, de modo que una sola API de mensajes directos cubre Zalo junto a Instagram, WhatsApp y Telegram.
Responde con texto, una imagen o un archivo adjunto, una cita a un mensaje específico, o botones de llamada a la acción. SocialAPI.ai mapea cada respuesta al payload de mensaje de consulta correcto de Zalo por ti, a través del mismo endpoint de envío de mensajes que ya usas en todas las demás plataformas de mensajería.
Crea, actualiza y elimina artículos y publicaciones de video de tu Official Account con los mismos endpoints de publicación que usas en Instagram, LinkedIn y Facebook. Zalo publica artículos de forma asíncrona, así que el conector consulta a Zalo hasta que el artículo está en vivo y te devuelve la publicación terminada en lugar de un token pendiente que tendrías que perseguir por tu cuenta.
Zalo usa autorización PKCE con un access token de vida corta y un refresh token de un solo uso que rota en cada renovación. SocialAPI.ai ejecuta el intercambio PKCE, renueva antes de la expiración y guarda el par rotado, así que una cuenta conectada sigue conectada sin una sola línea de código de tokens en tu aplicación.
Leer comentarios, DMs y menciones es gratis e ilimitado en todos los planes. Los planes de pago comienzan en $29/mes con posts e interacciones ilimitados. El nivel gratuito no requiere tarjeta de crédito.
FAQ
No. Zalo no expone una API pública para comentarios, reseñas ni menciones, así que SocialAPI.ai no puede ofrecerlos en Zalo. Obtienes mensajes directos y publicación de contenido. Todas las demás capacidades de la API unificada funcionan en las plataformas que sí las admiten.
Zalo exige que el dominio de redirección esté registrado como URL de callback de tu app y además verificado como dominio en el portal de Zalo (con registro DNS TXT, archivo HTML o meta tag). Configurar solo la URL de callback no basta. Verifica el dominio y la conexión se completará.
Sí. Zalo Official Account es el lado empresarial de Zalo, la app de mensajería dominante en Vietnam, y su Open API cubre mensajería y publicación de artículos. Usarlo en crudo implica operar autorización PKCE, verificación de dominio, refresh tokens rotativos de un solo uso y sondeo de artículos asíncronos por tu cuenta. SocialAPI.ai envuelve todo eso detrás de una sola API REST: conecta una Official Account y lee y responde mensajes desde la misma bandeja de entrada unificada que todas las demás plataformas.
Una Zalo Official Account (OA) es el perfil de empresa que una compañía opera en Zalo, la app de mensajería que usa la mayor parte de Vietnam. Los clientes le escriben a la OA igual que le escribirían a un número de WhatsApp Business, y la OA además puede publicar artículos y videos. El Open API de Zalo actúa en nombre de una sola Official Account por token conectado.
Zalo te permite enviar un mensaje de consulta solo si el cliente interactuó con tu Official Account en los últimos 7 días, y las respuestas dentro de las primeras 48 horas son gratuitas. Si la ventana se cerró, Zalo rechaza el envío y SocialAPI.ai devuelve un 422 con el motivo, para que puedas mostrarlo en tu propia interfaz en lugar de adivinar.
Zalo no cobra por las respuestas de consulta dentro de la ventana gratuita, y SocialAPI.ai empieza en $0: el plan Free incluye 2 perfiles sociales y 50 interacciones al mes, y los planes pagos tienen interacciones ilimitadas. Tú conservas la propiedad de tu Official Account y de tu app de Zalo.
Empieza hoy
Nivel gratuito disponible · Sin tarjeta de crédito · Incluye servidor MCP
We use essential cookies for security, and analytics cookies with your consent. Privacy Policy.