Convierte las conversaciones de tu negocio en WeChat en datos para entrenar: importa hoy tus chats exportados y conecta el canal en vivo cuando se active.
Qué funciona hoy
La importación de chats exportados de WeChat funciona hoy, en Importar datos.
El canal en vivo (WeChat Customer Service, 微信客服) ya está construido pero está pendiente de activación: en Herramientas › Conectores la tarjeta de WeChat aparece como Pendiente, con el botón Pendiente de activación deshabilitado y un enlace para importar un chat exportado.
Los tres formatos que reconocemos
WeChat no exporta el historial en texto por sí mismo: vive en tu teléfono, y para sacarlo se usan herramientas de terceros. AstrApp reconoce estos tres formatos, y solo estos tres:
| Herramienta y formato | Archivo | Qué aporta |
|---|---|---|
| WeChatMsg (留痕), CSV | .csv | Marca con IsSender los mensajes de la cuenta que exportó, así que AstrApp ya sabe cuáles son de tu negocio. Es el más fiable. |
| WeChatMsg (留痕), TXT | .txt | Escribe tu cuenta como 你 (también reconoce 我, you y me) y AstrApp la identifica. |
| WechatExporter, TXT | .txt | Sale de un respaldo de iPhone. No etiqueta tu cuenta: se deduce de la primera línea del archivo cuando la trae. |
No tienes que decir de qué formato se trata: AstrApp lo detecta por el contenido y revisa WeChat antes que WhatsApp, porque el TXT de WeChatMsg empieza con una fecha igual que un chat de WhatsApp. La vista previa te confirma cuál reconoció — Formato WeChat (CSV de WeChatMsg), (TXT de WeChatMsg) o (TXT de WechatExporter)— y si ahí ves otro formato, el archivo no es el que crees.
Estas herramientas no son de AstrApp
No las distribuimos ni las enlazamos: descárgalas solo de fuentes en las que confíes, y guarda el archivo tal como lo genere la herramienta, sin editarlo.
Sube el archivo en Importar datos
Entra a Importar datos y arrastra el archivo, elígelo con Elige el archivo o pega el texto en el cuadro de pegado. Arriba de la caja están las etiquetas de lo que se acepta —JSONL, JSON, CSV, TXT / WhatsApp, WeChat, XML y Parquet—; la de WeChat lleva su isotipo.
Si todavía no tienes el archivo, abre ¿Tus chats están en WeChat? debajo de la caja: ahí están las dos herramientas cuyo formato reconocemos y qué exporta cada una.
Di quién responde por tu negocio
En cuanto se lee el archivo aparece el selector ¿Quién responde por tu negocio? con los participantes del chat. Los mensajes de quien elijas se guardan como assistant y los de los demás como user. Los nombres de los participantes no se guardan en ningún caso: solo deciden el rol.
- Si el formato marca la cuenta que exportó —el CSV de WeChatMsg con su columna
IsSender, y su TXT porque escribe tu cuenta como你— llega elegida y la verás anotada como (la cuenta que exportó). - WechatExporter no la marca, pero si el archivo abre con una línea como
Ana - WeChat Chat Historyy en el chat solo hay una persona más, esa otra es tu cuenta y llega elegida. - Sin esa pista, en un chat entre dos personas llega elegida la segunda que habla, igual que en un chat de WhatsApp.
- Si no se puede decidir, llega vacío: el botón Siguiente queda deshabilitado y debajo se lee «Elige quién responde por tu negocio para continuar.». Es a propósito: sin eso todos los mensajes saldrían como
user.
Puedes cambiar la elección cuando quieras. En el CSV de todos tus chats, donde cada contacto es una conversación aparte, elegir a un contacto en vez de tu propia cuenta pone del lado del negocio a los contactos de todos los chats, no solo a ese nombre.
Revisa la privacidad y la vista previa
El segundo paso del asistente abre con Privacidad de las personas en tus chats y el interruptor Quitar datos personales antes de guardar marcado.
Qué quita el interruptor
Con él prendido, AstrApp cambia por marcadores como [EMAIL] los correos, teléfonos, tarjetas, IPs, IDs de WeChat, CURP, RFC, SSN, cédulas chinas y direcciones con calle y número, y guarda en cada conversación cuántos encontró de cada tipo. Justo debajo lees qué va a pasar con tu archivo: «Se quitarán 4: 3 correos, 1 teléfono.» o «Con estas reglas no encontramos datos personales.».
No detecta nombres de personas ni direcciones escritas de otra forma, así que revisa la muestra antes de confirmar.
Los marcadores siguen a Idioma de las conversaciones, en el mismo paso: en español quedan [TELÉFONO] y [DIRECCIÓN]; en inglés o en «Otro», [PHONE] y [ADDRESS]. Ese selector arranca en el idioma en que tengas la interfaz.
Qué te dice el panel de la derecha
- El formato que reconoció y que todo se normaliza a ChatML.
- Detectadas, Se importarán (con el tope de tu plan si aplica), Duplicados quitados y los mensajes por conversación.
- Cuántos datos personales se van a quitar, y los roles que quedaron en el resultado.
- Lo que quedó fuera: «Se omitieron 12 multimedia, 3 avisos del sistema y 0 mensajes de grupos.».
La limpieza cambia el duplicado
Los duplicados se detectan sobre lo que se guarda: el mismo archivo importado una vez con la limpieza prendida y otra con ella apagada se guarda dos veces.
Cómo se arman las conversaciones
- Solo texto. Multimedia, stickers y avisos del sistema se omiten y se cuentan aparte.
- Ráfagas juntas. Los mensajes seguidos de la misma persona se juntan en un turno, porque en WeChat se escribe en ráfagas.
- Pausa de 6 horas. Una pausa de 6 horas o más empieza una conversación nueva.
- Sin nombres. Los nombres de los participantes no se guardan: solo deciden el rol.
Chats de grupo
En un grupo no hay forma de saber quién responde por tu negocio, así que no sirven para entrenar.
En el CSV de WeChatMsg se omiten solos y la vista previa te dice cuántos mensajes de grupos quedaron fuera. Un grupo exportado como TXT sí se lee: si el archivo no marca tu cuenta, el negocio queda sin decidir y el asistente te pregunta; si la marca, llega elegida y todos los demás participantes quedan como cliente.
Por la API, la limpieza viene apagada
El asistente y POST /api/v1/ingest no traen los mismos valores por defecto:
| Opción | En el asistente | En POST /api/v1/ingest |
|---|---|---|
| Quitar datos personales | El interruptor viene marcado. | redactPii vale false si no lo mandas. |
| Idioma de las conversaciones | Arranca en el idioma de tu interfaz. | language vale "es" si no lo mandas, y eso decide el idioma de los marcadores. |
| Quién responde por tu negocio | Un selector con los participantes del chat. | parseOptions.businessSender, con el nombre exacto tal como aparece en el archivo. |
{
"text": "…el contenido del archivo…",
"fileName": "chat.txt",
"projectId": "<id del proyecto>",
"language": "es",
"parseOptions": { "businessSender": "Ana" },
"redactPii": true
}El endpoint, la autenticación y los demás campos del cuerpo están en la referencia de Datasets.
Canal en vivo: pendiente de activación
Requiere el plan Professional y que el dueño de AstrApp lo active. Todavía no hay fecha: no lo planees para una entrega.
Cuando se active, AstrApp recibirá los mensajes de tu cuenta de WeChat Customer Service a través de WeCom (企业微信) y guardará cada chat como conversación: lo que escribe el cliente como user y lo que responde tu equipo como assistant. Solo texto, y una pausa de 6 horas abre una conversación nueva, igual que al importar.
Qué vas a necesitar
Todo sale de la consola de administración de WeCom:
| Dato | De dónde sale |
|---|---|
| CorpID | El ID de tu empresa en la consola de WeCom (企业微信). |
| Secret | De una aplicación propia (自建应用) autorizada en 微信客服 → API. |
| Token y EncodingAESKey | Se generan en la configuración de callback (回调配置). El Token son hasta 32 letras o números; la EncodingAESKey son exactamente 43. |
| OpenKfId | La cuenta de atención de la que quieres las conversaciones. |
| URL de callback | La da AstrApp al guardar el conector, para pegarla en WeCom. |
El Secret, el Token y la EncodingAESKey se guardan cifrados y no vuelven al navegador: al editar el conector los verás vacíos, y dejarlos así conserva los guardados.
Qué hace AstrApp con las sesiones nuevas
Por defecto solo lee. Si enciendes Mover las sesiones nuevas a la cola de agentes, cada chat nuevo pasa a la cola de espera para que lo tome una persona de tu equipo; eso escribe en tu WeCom, así que la casilla viene apagada.
Antes de activarlo, habla con tu equipo
Al activar la API de 微信客服, WeCom deja de aplicar las reglas de recepción que tengas configuradas en su consola: un chat nuevo se queda sin atender hasta que algo lo asigne.
Importar CSV
Por qué un CSV de WeChat no pasa por los modos A y B del lector de tablas.
Crear datasets
Qué sigue después de importar: validar, etiquetar y exportar.
Webhooks
El registro de webhooks de AstrApp y su estado actual.
Importar conversaciones
Cuántas conversaciones reunir y qué las hace útiles para entrenar.