> ## Documentation Index
> Fetch the complete documentation index at: https://docs.min-ai.ar/llms.txt
> Use this file to discover all available pages before exploring further.

# WhatsApp

> Cada agente tiene su grupo de WhatsApp y le hablás desde tu WhatsApp de siempre. Con una línea de minai o con un número tuyo aparte.

En WhatsApp, cada agente vive en **su propio grupo**: el grupo tiene el nombre y la foto del agente, y adentro están vos y una **línea** (un número de WhatsApp que pone la voz del agente). Le escribís desde tu WhatsApp de siempre, como en cualquier grupo.

| | |
| - | - |
| **Para** | Agentes personales y de grupo |
| **Qué te pide** | Tu WhatsApp. Y, si elegís **Otra línea mía**, un segundo número |
| **Quién le habla** | Solo vos (o todo el grupo, si es un agente de grupo) |

## Qué necesitás

La primera vez que un agente usa WhatsApp, elegís la línea de tu cuenta. Esa línea la comparten todos tus agentes de WhatsApp, así que con los siguientes este paso ya no aparece.

* **Una línea de minai** («Sin número propio»): un número que pone minai. No necesitás nada más que tu WhatsApp.
* **Otra línea mía** («Un número aparte para tus agentes»): un **segundo número** de WhatsApp tuyo (otro teléfono, otro chip o un WhatsApp Business con otro número), distinto del que usás para chatear. Ese teléfono tiene que tener WhatsApp andando.

### ¿Por qué no puede ser mi propio número?

Porque WhatsApp no te avisa de los mensajes que manda tu propia cuenta: si el agente hablara desde tu número, nunca te enterarías de lo que te escribe. Por eso la línea siempre es otro número, y vos le hablás desde el tuyo.

<Info>
  Que tu agente **lea tus chats de WhatsApp** y te prepare respuestas es otra cosa: es el [plugin WhatsApp](/es/plugins/whatsapp). Ahí sí se usa tu número, y nada sale sin tu OK.
</Info>

## Cómo se conecta

<Tabs>
  <Tab title="Una línea de minai">
    <Steps>
      <Step title="Elegí WhatsApp">
        Al crear el agente, en **¿Dónde vas a hablar con Clara?**, tocá **WhatsApp** («Un grupo en tu WhatsApp»).
      </Step>

      <Step title="Elegí la línea">
        En **¿Qué línea?**, tocá **Una línea de minai**. Se asigna al instante: no hay nada que vincular. Si dice **Sin lugar**, por ahora no hay líneas libres y te conviene la otra opción.
      </Step>

      <Step title="Presentate a la línea">
        Tocá **Abrir WhatsApp**. Se abre un chat con el número de minai y un mensaje ya escrito, del estilo «Código de vinculación: HG7-KFH». Mandalo tal cual, desde tu WhatsApp de siempre. El código dura una hora.
      </Step>

      <Step title="Listo, tu grupo">
        La línea te contesta «Listo ✅ Te creo el grupo de Clara.» y te suma al grupo. En minai ves «Te creé el grupo «Clara»» → **Listo**. Tu agente te escribe ahí.
      </Step>
    </Steps>

    <Frame caption="Elegir la línea">
      <img src="https://mintcdn.com/min-ai/EQr5ljJyas4JWh5G/images/es/canal-whatsapp-linea.png?fit=max&auto=format&n=EQr5ljJyas4JWh5G&q=85&s=87dbedadfb15a4b18d49c88130ffbb6f" alt="Pantalla ¿Qué línea? con Una línea de minai y Otra línea mía" width="1280" height="657" data-path="images/es/canal-whatsapp-linea.png" />
    </Frame>

    La línea de minai la comparten varias cuentas, pero cada cuenta tiene sus grupos, su gente y sus mensajes por separado. Si le escribís a ese número por privado sin un código, te contesta una vez que los agentes hablan en sus grupos, no ahí.
  </Tab>

  <Tab title="Otra línea mía">
    <Steps>
      <Step title="Elegí WhatsApp y Otra línea mía">
        Al crear el agente, tocá **WhatsApp** y, en **¿Qué línea?**, **Otra línea mía**. Después, **Crear la línea**.
      </Step>

      <Step title="Vinculá la línea">
        En **Vinculá la línea** elegí cómo:

        * **Escanear QR**: en el teléfono de esa línea, abrí WhatsApp → **Dispositivos vinculados** → **Vincular un dispositivo** y escaneá el código (se renueva cada 30 segundos).
        * **Con un código**: poné el número de la línea (**País**, **Número**) y tocá **Pedir código**. En el teléfono de la línea, andá a **Vincular con número de teléfono** e ingresá el código que te muestra minai.

        minai muestra «Esperando la vinculación…» hasta que queda lista.
      </Step>

      <Step title="Presentate a la línea">
        Tocá **Abrir WhatsApp** y, **desde tu WhatsApp de siempre** (no desde la línea), mandá el mensaje con el código tal cual.
      </Step>

      <Step title="Listo, tu grupo">
        La línea crea el grupo del agente con vos adentro. En minai ves «Te creé el grupo «Clara»» → **Listo**.
      </Step>
    </Steps>

    La línea queda como un dispositivo vinculado de ese WhatsApp, igual que WhatsApp Web.
  </Tab>
</Tabs>

<Frame caption="Presentate a la línea desde tu WhatsApp de siempre">
  <img src="https://mintcdn.com/min-ai/EQr5ljJyas4JWh5G/images/es/canal-whatsapp-presentate.png?fit=max&auto=format&n=EQr5ljJyas4JWh5G&q=85&s=52e629e4642374123ce88be9a5448b5d" alt="Pantalla Presentate a la línea con el botón Abrir WhatsApp" width="1280" height="657" data-path="images/es/canal-whatsapp-presentate.png" />
</Frame>

## Cómo se comporta

* **Formato:** solo *negrita*, *cursiva*, ~~tachado~~ y bloques de código. **No hay tablas, títulos ni links con texto**: las direcciones van completas.
* **Sin botones:** WhatsApp no los tiene, así que las opciones llegan como **lista numerada** al final del mensaje. Contestás con el número o con el texto. Ver [Botones y opciones](/es/referencia/agente/botones).
* **Mientras trabaja:** ves «escribiendo…».
* **Archivos, fotos, audios y videos:** van y vienen.
* **Notas de voz:** se pasan a texto solas.
* **Reacciones:** funcionan para los dos lados.
* **Solo vos:** en el grupo de un agente personal, si sumás a alguien más, el agente no le contesta.
* **Para frenarlo:** mandá `/stop` solo, sin nada más.

En minai, el chat aparece en **Chats** con la marca de WhatsApp: lo leés ahí, pero se contesta desde WhatsApp.

## Reconectar si algo falla

<Tabs>
  <Tab title="Una línea de minai">
    Si la línea tiene un problema, en **Resumen** → **Dónde habla** ves **Sin línea** y «Es una línea de minai y ya la estamos reconectando.». No tenés que hacer nada: tu agente vuelve a contestar apenas esté.
  </Tab>

  <Tab title="Otra línea mía">
    minai revisa la línea cada pocos minutos. Si se desvinculó (por ejemplo, la quitaste de **Dispositivos vinculados**), en **Dónde habla** ves **Sin línea** y «Tu línea de WhatsApp se desvinculó…». Como es la línea de todos tus agentes de WhatsApp, se cortan todos. Tocá **Vinculá la línea de nuevo** y repetí el QR o el código: vuelven todos juntos.
  </Tab>
</Tabs>

## Cambiar de canal

Un agente personal puede pasar de WhatsApp a otro canal y llevarse todo. En el grupo viejo deja un último mensaje («Este grupo ya no se usa: podés salir y borrarlo.») y la línea sale del grupo. Ver [Cambiar un agente](/es/configurar/cambiar-un-agente).

## Límites

* Tu propio número nunca puede ser la línea.
* Una sola línea por cuenta, compartida por todos tus agentes de WhatsApp. Tener **Otra línea mía** cuenta en tu [plan](/es/referencia/planes) como «WhatsApp propio»; la línea de minai no cuenta.
* Si le cambiás el nombre a un agente personal, su grupo cambia de nombre y de foto. El grupo de un agente de grupo conserva su nombre.
* Hasta 15 MB por archivo.
* Los avisos de que te escribió te los da WhatsApp, no minai.

<CardGroup cols={2}>
  <Card title="Plugin WhatsApp" icon="https://mintcdn.com/min-ai/EQr5ljJyas4JWh5G/images/plugins/whatsapp.png?fit=max&auto=format&n=EQr5ljJyas4JWh5G&q=85&s=90e5e8840e6a973e320cb40ea281dea8" href="/es/plugins/whatsapp" width="128" height="128" data-path="images/plugins/whatsapp.png">
    Que tu agente lea tus chats y responda con tu OK.
  </Card>

  <Card title="Agentes para un grupo" icon="users" href="/es/referencia/canales/grupos">
    Un agente en un grupo de WhatsApp, para todos.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.