MAX es un mensajero ruso, y AiHummer se conecta a él como un canal. El agente aparece en MAX como un bot: recibe mensajes entrantes, ejecuta un turno normal y envía la respuesta de vuelta, al igual que Telegram y los otros canales.
MAX se envía como un Conector de canal de mercado y está construido sobre el API de Bot MAXNo es un servicio que construyas tú mismo: instalas el conector desde el Marketplace dentro del producto y lo configuras desde la interfaz de administración, como cualquier otro canal.
Instalar desde el Marketplace
Abrir dentro del producto Mercado e instalar el MÁX módulo. Una vez instalado, el canal aparece en la sección de canales de la interfaz de administración con el id del canal max — utiliza ese ID cuando vincules un agente o filtres conversaciones por fuente.
[!NOTE]
El canal MAX requiere un activo Arrancador, Negocios o Empresa
licencia. En el plan Comunitario, instalar el conector devuelve
HTTP 402 “actualización requerida” (código plan_limit) — ver
Licenciamiento.
Configúralo desde la interfaz de administración
Crea un bot MAX y obtén su token.
En la interfaz de administración, abre el MÁX configuración del canal.
Pega el token del bot en MAX_BOT_TOKEN (un secreto, requerido).
Opcionalmente configure la URL base del API de MAX Bot en MAX_API_BASE. Se establece por defecto en
https://platform-api2.max.ru, así que normalmente puedes dejar esto en blanco.
Guardar — el conector comienza a recibir y enviar mensajes.
[!TIP]
MAX es el canal identificado a AiHummer como max. Usa ese id de canal cuando tú
vincular un agente o filtrar conversaciones por fuente.
Qué se admite
El conector MAX cubre los flujos de conversación principales:
Enviar y recibir mensajes entre el agente y los usuarios de MAX.
Entrada de sondeo prolongado — el conector obtiene actualizaciones entrantes (menciones,
respuestas, medios, eventos interactivos), por lo que no se requiere un puerto público de entrada.
Respuestas nativas a un mensaje específico.
Teclados en línea básicos para botones interactivos rápidos.
Medios-por-URL en mensajes salientes.
Eliminar duplicados por clave, por lo que un reintento de entrega nunca produce un duplicado.
Cómo fluyen los mensajes
Cada mensaje MAX entrante llega a la puerta de enlace por la misma ruta de entrada que cualquier otro canal, asegurada por la compartida secreto HMAC entrante. Desde allí, el motor de turnos lo procesa como cualquier otro mensaje de canal.
[!NOTE]
La puerta de enlace debe tener un espacio de trabajo predeterminado configurado para enviar entradas
mensajes.
**MAX es un mensajero ruso, y AiHummer se conecta a él como un canal.** El agente aparece en MAX como un bot: recibe mensajes entrantes, ejecuta un turno normal y envía la respuesta de vuelta, al igual que Telegram y los otros canales.
MAX se envía como un **Conector de canal de mercado** y está construido sobre el **API de Bot MAX**No es un servicio que construyas tú mismo: instalas el conector desde el Marketplace dentro del producto y lo configuras desde la interfaz de administración, como cualquier otro canal.
## Instalar desde el Marketplace
Abrir dentro del producto [Mercado](/es/v1.0/marketplace/overview-tiers) e instalar el **MÁX** módulo. Una vez instalado, el canal aparece en la sección de canales de la interfaz de administración con el id del canal `max` — utiliza ese ID cuando vincules un agente o filtres conversaciones por fuente.
> [!NOTE]
> El canal MAX requiere un activo **Arrancador**, **Negocios** o **Empresa**
> licencia. En el plan Comunitario, instalar el conector devuelve
> **HTTP 402 "actualización requerida"** (código `plan_limit`) — ver
> [Licenciamiento](/es/v1.0/commercial/licensing).
## Configúralo desde la interfaz de administración
1. Crea un bot MAX y obtén su token.
2. En la interfaz de administración, abre el **MÁX** configuración del canal.
3. Pega el token del bot en **`MAX_BOT_TOKEN`** (un secreto, requerido).
4. Opcionalmente configure la URL base del API de MAX Bot en **`MAX_API_BASE`**. Se establece por defecto en
`https://platform-api2.max.ru`, así que normalmente puedes dejar esto en blanco.
5. Guardar — el conector comienza a recibir y enviar mensajes.
> [!TIP]
> MAX es el canal identificado a AiHummer como `max`. Usa ese id de canal cuando tú
> vincular un agente o filtrar conversaciones por fuente.
## Qué se admite
El conector MAX cubre los flujos de conversación principales:
- **Enviar y recibir mensajes** entre el agente y los usuarios de MAX.
- **Entrada de sondeo prolongado** — el conector obtiene actualizaciones entrantes (menciones,
respuestas, medios, eventos interactivos), por lo que no se requiere un puerto público de entrada.
- **Respuestas nativas** a un mensaje específico.
- **Teclados en línea básicos** para botones interactivos rápidos.
- **Medios-por-URL** en mensajes salientes.
- **Eliminar duplicados por clave**, por lo que un reintento de entrega nunca produce un duplicado.
## Cómo fluyen los mensajes
Cada mensaje MAX entrante llega a la puerta de enlace por la misma ruta de entrada que cualquier otro canal, asegurada por la compartida **secreto HMAC entrante**. Desde allí, el motor de turnos lo procesa como cualquier otro mensaje de canal.
> [!NOTE]
> La puerta de enlace debe tener un espacio de trabajo predeterminado configurado para enviar entradas
> mensajes.
## ¿A dónde vamos ahora?
- Comparar con el canal de chat similar: [Telegram](/es/v1.0/channels/telegram).
- Sobre la instalación de conectores: [Mercado](/es/v1.0/marketplace/overview-tiers).
- ¿Acabas de empezar? Ve el [Inicio rápido](/es/v1.0/getting-started/quickstart).
