Primeros pasos

Importa tu cuenta de WhatsApp Business

Ve a la página de 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:

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:

Configura cómo se comporta el agente en este número (consulta la referencia completa en la configuración de la cuenta):

• 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:

La conversación aparecerá en tu historial de conversaciones a medida que se produzca.

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, por ejemplo:

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

Cuando se apruebe la plantilla, envíala:

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",
)

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, 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í.