Soporte en mini programas de WeChat

Paso 1: conectar desde la página «Canales» del panel. Introduce el AppID y el AppSecret del Mini Program (WeChat Official Accounts Platform → Desarrollo → Gestión de desarrollo → Configuración de desarrollo). Antes de guardar, se hará un intercambio real de access_token con WeChat; si hay un error, se mostrará directamente el motivo. Usamos el endpoint stable_token para obtener el token, así no invalidamos el token que ya esté usando tu propio servidor.

Paso 2: configurar el push de mensajes. En WeChat Official Accounts Platform → Desarrollo → Gestión de desarrollo → Configuración de desarrollo → Push de mensajes, actívalo y rellena los datos que aparecen en la página «Canales»:

Al enviar, WeChat validará la URL; cuando la validación sea correcta, el estado del canal cambiará a «En ejecución». Si el Mini Program tiene habilitada la lista blanca de IP, añade la IP del servidor que se muestra en la página de canales.

Paso 3: colocar un botón en el Mini Program.

<button open-type="contact" session-from="{{userToken}}">联系客服</button>

Coloca en session-from el user_token emitido por tu servidor (el formato se describe en Identificar a los clientes que inician sesión); así la IA sabrá qué miembro es el cliente y podrá consultar sus pedidos. Si no lo incluyes, se tratará como cliente anónimo. El token solo se valida una vez, cuando el cliente entra en la conversación; se recomienda que exp sea de al menos 1 hora.

Notas:

• El cliente puede recibir respuesta dentro de las 48 horas posteriores al envío de su mensaje (normativa de WeChat); si se supera ese plazo, hay que esperar a que el cliente vuelva a enviar un mensaje. Las respuestas que no se puedan enviar se marcan en rojo en «Conversaciones» y se indica el motivo.
• Actualmente se procesan mensajes de texto y tarjetas de Mini Program; las imágenes y los mensajes de voz se registran en la conversación para que el agente los vea, y cuando la IA atiende, pide al cliente que describa el asunto por texto.
• Si rellenas la «Ruta de la página de producto» en el canal (por ejemplo, pages/goods/detail?id={id}), la IA enviará además una tarjeta de Mini Program con los productos recomendados, sustituyendo {id} por el external_id del producto. El producto debe tener una imagen JPG o PNG para que se envíe la tarjeta.
• Cuando el mismo cliente entra por primera vez en la conversación de atención al cliente dentro de un período de 24 horas, se envía un mensaje de bienvenida una vez; se puede desactivar en el canal. El contenido usa el mensaje de bienvenida de «Configuración del bot».
• Los mensajes de WeChat Customer Service no admiten Markdown; la IA responderá en texto plano.