> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# Primeros pasos

## Qué vas a crear

Al final de esta guía, tu agente responderá mensajes de texto y notas de voz de WhatsApp en tu número de empresa, y habrás enviado un mensaje de plantilla iniciado mediante API. Calcula unos 20 minutos, más una breve espera para que Meta apruebe tu primera plantilla.

## Antes de empezar

Necesitas:

* Un [agente de ElevenLabs](/docs/es/eleven-agents/quickstart). Sirve cualquier agente existente.
* Un [portfolio empresarial de Meta](https://business.facebook.com/) que puedas administrar.
* Un número de teléfono que **no** se esté usando actualmente en la app WhatsApp Business ni esté registrado con otro proveedor de WhatsApp. No se pueden importar números que se usen en otro lugar; consulta las [limitaciones](/docs/es/eleven-agents/whatsapp#limitations).
* Un método de pago en [WhatsApp Manager](https://business.facebook.com/latest/whatsapp_manager/) si tienes previsto enviar plantillas o hacer llamadas. Meta factura estos servicios por separado de ElevenLabs.

#### Importa tu cuenta de WhatsApp Business

Ve a la [página de WhatsApp](https://elevenlabs.io/app/agents/whatsapp) y haz clic en el botón ***Importar cuenta***. Se abrirá el flujo de autorización de Meta, donde seleccionarás (o crearás) la cuenta de WhatsApp Business y el número de teléfono, y concederás a ElevenLabs permiso para administrarlos:

![Flujo de autorización de WhatsApp](/docs/_fern-img/9e5238e98f926582db314e9debc187a7dc29fd38a980cb732b4563b373110351.webp)

#### Asigna tu agente y elige los comportamientos

Tras la importación, llegarás a la página de configuración de la cuenta. Asigna un agente: hasta que lo hagas, se ignorarán los mensajes entrantes y se rechazarán las llamadas entrantes:

![Página de cuenta de WhatsApp](/docs/_fern-img/f5598ac70ade00048effb5ee3bf6cbc93cd61876652eb3ce5917ac21c6209bf6.webp)

Configura cómo se comporta el agente en este número (consulta la referencia completa en la [configuración de la cuenta](/docs/es/eleven-agents/whatsapp#account-settings)):

* **Activar mensajería**: determina si el agente responde a los mensajes. Desactívalo si otro sistema gestiona los mensajes y ElevenLabs solo debe gestionar llamadas.
* **Activar respuesta a mensajes de audio**: al activarlo, el agente responde a las notas de voz con notas de voz en su propia voz; al desactivarlo, siempre responde con texto.
* **Activar indicador de escritura**: al activarlo, el agente marca los mensajes entrantes como leídos y muestra un indicador de escritura mientras trabaja.

#### Ten tu primera conversación

Envía un mensaje a tu número de empresa desde un teléfono personal. El agente responderá. Envía una nota de voz: se transcribirá para el agente, y este responderá con una nota de voz propia:

![Conversación de texto de WhatsApp](/docs/_fern-img/4c31b4d2b5eccccd7cddfa81144176a6d3c32f4670add5306f3a6ef78bc05244.webp)

La conversación aparecerá en tu [historial de conversaciones](https://elevenlabs.io/app/agents/history) a medida que se produzca.

> **Info**
>
> Una conversación de mensajes termina cuando el agente utiliza la herramienta del sistema ***Finalizar conversación***, transcurre la
> ***Duración máxima de la conversación*** o vence el tiempo de espera predeterminado de 15 minutos de inactividad
> tras la respuesta más reciente del agente. El siguiente mensaje del usuario inicia una nueva
> conversación. Consulta más información sobre los [tiempos de espera de las conversaciones](/docs/es/eleven-agents/customization/conversation-flow#maximum-conversation-duration).

#### Envía tu primer mensaje saliente

Para contactar primero con un usuario necesitas una **plantilla de mensaje** aprobada por Meta: WhatsApp solo permite mensajes empresariales de formato libre dentro de una conversación activa. Crea una plantilla sencilla de utilidad en [WhatsApp Manager](https://business.facebook.com/latest/whatsapp_manager/message_templates), por ejemplo:

```text
Hi {{name}}, thanks for signing up. Reply here if you have any questions.
```

Cuando se apruebe la plantilla, envíala:

#### Python

```python
from elevenlabs import ElevenLabs

elevenlabs = ElevenLabs()

elevenlabs.conversational_ai.whatsapp.outbound_message(
    whatsapp_phone_number_id="524029457612345",
    whatsapp_user_id="12213231492",
    template_name="welcome",
    template_language_code="en",
    template_params=[
        {
            "type": "body",
            "parameters": [
                {"type": "text", "parameter_name": "name", "text": "Daniele"}
            ],
        }
    ],
    agent_id="agent_9201kwcrbq9qfxaa2t8nnnkqf2w9",
)
```

#### TypeScript

```typescript
import { ElevenLabsClient } from "@elevenlabs/elevenlabs-js";

const elevenlabs = new ElevenLabsClient();

await elevenlabs.conversationalAi.whatsapp.outboundMessage({
  whatsappPhoneNumberId: "524029457612345",
  whatsappUserId: "12213231492",
  templateName: "welcome",
  templateLanguageCode: "en",
  templateParams: [
    {
      type: "body",
      parameters: [{ type: "text", parameterName: "name", text: "Daniele" }],
    },
  ],
  agentId: "agent_9201kwcrbq9qfxaa2t8nnnkqf2w9",
});
```

#### cURL

```bash
curl -X POST https://api.elevenlabs.io/v1/convai/whatsapp/outbound-message \
  -H "xi-api-key: $ELEVENLABS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "whatsapp_phone_number_id": "524029457612345",
    "whatsapp_user_id": "12213231492",
    "template_name": "welcome",
    "template_language_code": "en",
    "template_params": [
      {
        "type": "body",
        "parameters": [
          {"type": "text", "parameter_name": "name", "text": "Daniele"}
        ]
      }
    ],
    "agent_id": "agent_9201kwcrbq9qfxaa2t8nnnkqf2w9"
  }'
```

Aquí importan dos detalles:

* `template_params` es una lista de objetos de componente: el contenedor `{"type": "body", ...}` es obligatorio.
* `whatsapp_user_id` solo contiene dígitos, con el código de país y sin `+` (por ejemplo, `14155552671`).

Encuentra tu `whatsapp_phone_number_id` en la [página de WhatsApp](https://elevenlabs.io/app/agents/whatsapp), mediante la opción ***Copiar ID de número de teléfono*** del menú de la cuenta.

Tu teléfono recibirá la plantilla. Respóndela: el agente continuará la conversación desde ahí.

## Si algo no ha funcionado

* **El agente nunca responde**: no hay ningún agente asignado al número o **Activar mensajería** está desactivado. Si todo parece correcto, comprueba si el agente requiere [variables dinámicas](/docs/es/eleven-agents/customization/personalization/dynamic-variables): una conversación entrante de WhatsApp comienza sin valores proporcionados por el usuario, por lo que un agente cuyas herramientas o primer mensaje requieran uno fallará antes de responder, salvo que un webhook de inicio de conversación lo proporcione. Consulta el [contexto de inicialización](/docs/es/eleven-agents/whatsapp#initialization-context).
* **La importación falla**: el número ya está registrado con otro proveedor o con la app WhatsApp Business.
* **La API ha devuelto 200, pero no ha llegado ningún mensaje**: la plantilla aún no está aprobada, los parámetros no coinciden con la plantilla o tu cuenta de WhatsApp Business tiene pagos pendientes (error 131042 de Meta).
* **La respuesta del usuario ha iniciado una conversación independiente sin contexto**: el formato del ID de destinatario era incorrecto; consulta el [formato del número de destinatario](/docs/es/eleven-agents/whatsapp/outbound#recipient-number-format).

Para cualquier otro caso, consulta [Resolución de problemas y preguntas frecuentes](/docs/es/eleven-agents/whatsapp/troubleshooting).

## Próximos pasos

* Personaliza conversaciones con [variables dinámicas](/docs/es/eleven-agents/whatsapp/outbound#dynamic-variables-branches-and-environments) y las [variables del sistema de personalización](/docs/es/eleven-agents/whatsapp#personalization).
* Realiza campañas de contacto a gran escala con [mensajes salientes y plantillas](/docs/es/eleven-agents/whatsapp/outbound).
* Permite que el agente ofrezca opciones que se pueden tocar con [mensajes interactivos](/docs/es/eleven-agents/whatsapp/interactive-messages).
* Envía mensajes de WhatsApp desde agentes en otros canales con [herramientas de WhatsApp](/docs/es/eleven-agents/whatsapp/tools).
* Consulta los costes en las [preguntas frecuentes sobre precios](/docs/es/eleven-agents/whatsapp/troubleshooting#faq).