Para ayudar a las Cuentas Oficiales a lograr operaciones comerciales flexibles, la plataforma de Cuentas Oficiales de WeChat ha agregado una interfaz de menú personalizada, a través de la cual los desarrolladores pueden permitir que diferentes grupos de usuarios de Cuentas Oficiales vean diferentes menús personalizados. Esta interfaz está abierta a cuentas de suscripción autenticadas y cuentas de servicio autenticadas.
Los desarrolladores pueden configurar el menú que ven los usuarios a través de las siguientes condiciones:
- Etiquetas de usuario (las necesidades comerciales del desarrollador se pueden satisfacer con la ayuda de etiquetas de usuario)
género- sistema operativo móvil
Región (la región establecida por el usuario en el cliente de WeChat)Idioma (el idioma establecido por el usuario en el cliente de WeChat)
Nota: Para proteger la privacidad personal, el menú personalizado de la cuenta oficial ya no admitirá la función de filtrado de información relacionada con datos de privacidad personal como género, región e idioma. Los ajustes específicos son los siguientes:
- Al crear, siempre que la condición de coincidencia contenga información privada, se rechazará y se devolverá el código de error 65320;
- Si ha sido creado, si contiene información privada, automáticamente dejará de ser válido, y si no la contiene, coincidirá normalmente;
- Los desarrolladores aún pueden obtener el menú que ven los fanáticos a través de la interfaz de prueba normalmente;
- Al consultar el menú personalizado, todas las reglas se muestran normalmente.
Descripción de la interfaz de menú personalizada:
- El menú personalizado requiere que la versión del cliente de WeChat del usuario sea iPhone6.2.2, Android 6.2.4 o superior, y otras versiones de WeChat no son compatibles por el momento.
- La estrategia de actualización del menú es que cuando el usuario ingresa a la página de sesión de la cuenta oficial o a la página de perfil de la cuenta oficial, si se encuentra que la última solicitud para extraer el menú fue hace 5 minutos, se extraerá el menú. el cliente se actualizará en el menú lateral. Durante la prueba, puede intentar dejar de seguir la cuenta pública y seguirla nuevamente, puede ver el efecto después de la creación
- El número de nuevas interfaces del menú personalizado de la cuenta oficial general está limitado a 2000 veces por día, la interfaz de eliminación también es de 2000 veces y la interfaz de prueba del resultado coincidente del menú personalizado es de 20000 veces
- Por razones de seguridad, todos los menús personalizados de una cuenta oficial solo se pueden configurar para saltar a enlaces con 3 nombres de dominio como máximo
- Antes de crear un menú personalizado, primero debe crear un menú predeterminado (el menú predeterminado se refiere al menú creado mediante la interfaz común de creación de menús personalizados). Si elimina el menú predeterminado, también se eliminan todos los menús personalizados
- La interfaz de menú personalizada admite etiquetas de usuario, los desarrolladores deben tener en cuenta que cuando un usuario tiene más de una etiqueta, la última etiqueta se utilizará como coincidencia.
Descripción de las reglas de combinación de menú personalizado:
Las actualizaciones del menú personalizado se sobrescribirán. Por ejemplo, la cuenta oficial ha lanzado el menú predeterminado, el menú personalizado 1, el menú personalizado 2 y el menú personalizado 3. Luego, cuando el usuario ingrese a la página de la cuenta oficial, la coincidencia comenzará desde el menú personalizado 3. Si el menú personalizado 3 se combina con éxito, regrese directamente al menú personalizado 3, de lo contrario, continúe tratando de hacer coincidir el menú personalizado 2 hasta que un el menú se ha emparejado con éxito. De acuerdo con las reglas de coincidencia anteriores, para evitar confusiones sobre el tiempo efectivo del menú, se decide no proporcionar una API de edición de menú personalizada. Cuando los desarrolladores necesitan actualizar el menú, deben volver a publicar la configuración completa para una ronda. .
Tabla de contenido
3 Pruebe los resultados de coincidencia de menús personalizados
Crea un menú personalizado
Método de solicitud http: POST (utilice el protocolo https)
https://api.weixin.qq.com/cgi-bin/menu/addconditional?access_token=ACCESS_TOKEN
ejemplo de solicitud
{
"button": [
{
"type": "click",
"name": "今日歌曲",
"key": "V1001_TODAY_MUSIC"
},
{
"name": "菜单",
"sub_button": [
{
"type": "view",
"name": "搜索",
"url": "http://www.soso.com/"
},
{
"type": "miniprogram",
"name": "wxa",
"url": "http://mp.weixin.qq.com",
"appid": "wx286b93c14bbf93aa",
"pagepath": "pages/lunar/index"
},
{
"type": "click",
"name": "赞一下我们",
"key": "V1001_GOOD"
}
]
}
],
"matchrule": {
"tag_id": "2",
"sex": "1",
"country": "中国",
"province": "广东",
"city": "广州",
"client_platform_type": "2",
"language": "zh_CN"
}
}
Descripción de parámetros
| parámetro | Es necesario | ilustrar |
|---|---|---|
| botón | Sí | La matriz de menú de primer nivel, el número debe ser 1 ~ 3 |
| sub_boton | No | Matriz de menú secundario, el número debe ser 1 ~ 5 |
| tipo | Sí | El tipo de acción de respuesta del menú, la vista indica el tipo de página web, el clic indica el tipo de clic y el miniprograma indica el tipo de subprograma |
| nombre | Sí | Título del menú, no más de 16 bytes, submenú no más de 40 bytes |
| llave | Los clics y otros tipos de clics deben | Valor de la CLAVE del menú, utilizado para la inserción de la interfaz de mensajes, no más de 128 bytes |
| URL | vista, el tipo de miniprograma debe | Enlace de página web, el usuario hace clic en el menú para abrir el enlace, no más de 1024 bytes. Cuando el tipo es miniprograma, los clientes de versiones antiguas que no soportan miniprogramas abrirán esta url |
| media_id | El tipo media_id |
Llame al media_id legal devuelto por la nueva interfaz de material permanente |
| ID del artículo | tipo article_id y tipo article_view_limited deben | Article_id legal obtenido después de la publicación |
| appido | El tipo de miniprograma debe | El appid del applet |
| ruta de página | El tipo de miniprograma debe | La ruta de la página del applet. |
| regla del partido | Sí | Reglas de concordancia del menú |
| etiqueta_id | No | La identificación de la etiqueta de usuario, que se puede obtener a través de la interfaz de administración de etiquetas de usuario |
| sexo | derogado | Género: Masculino (1) Femenino (2), no hay coincidencia si se deja en blanco |
| tipo_plataforma_cliente | No | Versión del cliente, actualmente solo específica para el modelo del sistema: IOS (1), Android (2), Otros (3), si no se completa, no se realizará ninguna coincidencia |
| país | derogado | La información del país es la región establecida por el usuario en WeChat, consulte la tabla de información de la región para obtener más detalles. |
| provincia | derogado | La información de la provincia es la región establecida por el usuario en WeChat, consulte la tabla de información de la región para obtener más detalles. |
| ciudad | derogado | La información de la ciudad es la región establecida por el usuario en WeChat, consulte la tabla de información de la región para obtener más detalles. |
| idioma | derogado | La información de idioma es el idioma establecido por el usuario en WeChat. Para obtener más información, consulte la tabla de idiomas: 1. Chino simplificado "zh_CN" 2. Chino tradicional TW "zh_TW" 3. Chino tradicional HK "zh_HK" 4. Inglés "en 5. "id" indonesio 6, "ms" malayo 7, "es" español 8, "ko" coreano 9, "it" italiano 10, "ja" japonés 11, "pl" polaco 12, "pt" portugués 13 , ruso" ru" 14, tailandés "th" 15, vietnamita "vi" 16, árabe "ar" 17, norte de la India "hi" 18, hebreo "he" 19, turco "tr" 20, alemán "de" 21, francés "fr" |
El botón ya no admitirá materiales permanentes de tipo gráfico (noticias) media_id. Utilícelo article_iden lugar de regla de coincidencia. Hay siete campos en total, todos los cuales pueden estar vacíos, pero no todos vacíos. Al menos una información coincidente no debe estar vacía. País, provincia y ciudad forman la información de la región, la cual se verificará en el orden de país, provincia y ciudad, y debe ajustarse al contenido de la tabla de información de la región. La información regional se verifica de mayor a menor, y las pequeñas se pueden dejar en blanco, es decir, si se llena la información de la provincia, también se debe llenar y cotejar la información del país, y la información de la ciudad se puede dejar en blanco. Por ejemplo, "Ciudad de Guangzhou, Provincia de Guangdong, China" y "Provincia de Guangdong, China" son información geográfica legal, pero "Ciudad de Guangzhou, China" no es legal porque se completa la información de la ciudad pero no la de la provincia. Haga clic para descargar la hoja de información de la región .
resultado devuelto
El paquete de datos JSON devuelto cuando es correcto es el siguiente: Para obtener el código de retorno cuando es incorrecto, consulte la descripción del código de retorno de la interfaz.
{"menuid":"208379533"}Aviso
Preste atención a los campos eliminados en la tabla de descripción de parámetros. Estos campos involucran la privacidad personal de los ciudadanos. Si se completan estos campos, la interfaz arrojará los siguientes resultados:
{"errcode":65320,"errmsg":"match rule violates privacy"}Para otros códigos de retorno, consulte la descripción del código de retorno de la interfaz.
eliminar menú personalizado
Método de solicitud http: POST (utilice el protocolo https)
https://api.weixin.qq.com/cgi-bin/menu/delconditional?access_token=ACCESS_TOKEN
ejemplo de solicitud
{"menuid":"208379533"}menuid es la identificación del menú, que se puede obtener a través de la interfaz de consulta del menú personalizado.
El paquete de datos JSON devuelto cuando es correcto es el siguiente: Para obtener el código de retorno cuando es incorrecto, consulte la descripción del código de retorno de la interfaz. :
{"errcode":0,"errmsg":"ok"}Pruebe los resultados de la coincidencia del menú personalizado
Método de solicitud http: POST (utilice el protocolo https)
https://api.weixin.qq.com/cgi-bin/menu/trymatch?access_token=ACCESS_TOKEN
ejemplo de solicitud
{"user_id":"weixin"}user_id puede ser el OpenID de un fan o el ID de WeChat de un fan.
Return result Esta interfaz devolverá la configuración del menú, el ejemplo es el siguiente:
{
"button": [
{
"type": "view",
"name": "tx",
"url": "http://www.qq.com/",
"sub_button": [ ]
},
{
"type": "view",
"name": "tx",
"url": "http://www.qq.com/",
"sub_button": [ ]
},
{
"type": "view",
"name": "tx",
"url": "http://www.qq.com/",
"sub_button": [ ]
}
]
}
Tenga en cuenta que los menús que contengan campos en desuso también se invalidarán automáticamente y ya no coincidirán. Este punto también se verá reflejado en esta interfaz de prueba.
Además, para conocer el código de retorno cuando se produce un error, consulte la descripción del código de retorno de la interfaz.
Consulta menú personalizado
El menú predeterminado y toda la información del menú personalizado se pueden obtener utilizando la interfaz de consulta del menú personalizado común, consulte la descripción de la interfaz de consulta del menú personalizado.
Tenga en cuenta que los menús que contienen campos en desuso se devolverán normalmente cuando se consulten , pero ya no son válidos.
eliminar todos los menús
Todos los menús personalizados (incluido el menú predeterminado y todos los menús personalizados) se pueden eliminar mediante la interfaz común de eliminación de menús personalizados; consulte la descripción de la interfaz de eliminación de menús personalizados.