> ## Documentation Index > Fetch the complete documentation index at: https://docs.notfy.ai/llms.txt > Use this file to discover all available pages before exploring further. > ## Agent Instructions > Responda sempre em português do Brasil, com os nomes de menus e botões exatamente como aparecem no painel do Notfy. > Use somente o que está documentado aqui. Se a documentação não cobrir a pergunta, diga isso e indique a página mais próxima em vez de inventar. > Funcionalidades podem depender do plano, do segmento da empresa, das permissões do usuário e de integrações ativas: cite essa condição quando a página a mencionar. > Nunca peça nem repita senhas, tokens ou dados pessoais de clientes. # WhatsApp Oficial (Cloud API) > Conecte un número a Notfy mediante la API oficial de WhatsApp (Meta): cree la integración, informe las credenciales, configure el webhook y verifique la conexión. La integración **WhatsApp (Meta Oficial)** conecta un número a la API oficial de WhatsApp. Con ella atiende en el chat, envía plantillas de mensaje aprobadas y realiza campañas dentro de las reglas de Meta. ## Cuándo usar Úsela para conectar de forma oficial el número principal de la empresa. La cantidad de números que puede conectar depende del plan y aparece en **Configuración de la empresa**, pestaña **Consumo**, sección **WhatsApp (Slots)**. ## Antes de comenzar * Una cuenta en Meta Business Suite con acceso a Meta for Developers. * Un número dedicado a WhatsApp Business en la Cloud API. * Una aplicación creada en Meta for Developers con el producto WhatsApp. ## Formas de conexión | Forma | Cómo funciona | | :- | :- | | **Conexión Rápida** | Meta completa los campos por usted, con el botón **Conectar con Meta (Embedded Signup)** | | **Conexión Manual** | Usted informa los IDs y el token generados en Meta for Developers | > [!NOTE] > > La **Conexión Rápida** solo aparece después de guardar la integración y cuando el registro aún no tiene credenciales manuales. Si no está disponible, use la **Conexión Manual**. ## Conectar manualmente **1. Cree la integración** En **Ajustes**, **Integraciones**, cree una integración. En **Tipo de integración**, elija **WhatsApp (Meta Oficial)**, indique el **Nombre de la integración** (por ejemplo, WhatsApp Ventas) y guarde. Las pestañas específicas solo aparecen después de guardar. **2. Abra la pestaña de WhatsApp** En la integración guardada, abra la pestaña **WhatsApp (Meta Oficial)**. **3. Complete la Conexión Manual** Informe los datos de Meta for Developers y guarde. **4. Configure el webhook en Meta** En **Configuración de Webhook**, copie la **URL de Callback del Webhook**. Haga clic en el ícono de generar token para crear el **Token de Verificación del Webhook** y guarde. Luego, en Meta for Developers, abra WhatsApp, Configuración, Webhooks, pegue la URL y el token y suscríbase al evento de mensajes. **5. Verifique la conexión** En **Credenciales de Meta Cloud**, haga clic en **Verificar Conexión**. Si todo está correcto, aparece **¡Conexión Exitosa!** y el estado cambia a **Conectado**. ### Campos de la Conexión Manual | Campo | Dónde encontrarlo en Meta | | :- | :- | | **ID del Número de Teléfono** | WhatsApp, Configuración de la API | | **ID de la Cuenta de WhatsApp Business** | Parte superior de la misma página de configuración de la API | | **Token de Acceso Permanente** | Token permanente generado en la configuración de la aplicación | | **Secreto del App** | Configuración, Básico, "Clave secreta de la app". Valida cada mensaje recibido | > [!WARNING] > > El token y el Secreto del App no se muestran después de guardados. Al editar, déjelos en blanco para mantener los valores actuales. ### Activar el número (migración) El botón **Activar Número (Registro)** es necesario solo si migró un número que ya estaba en la aplicación WhatsApp Business. Solicita el **PIN de 6 dígitos** de la verificación en dos pasos, que no es el código recibido por SMS. > [!WARNING] > > Los intentos con un PIN incorrecto pueden bloquear el número temporalmente. Si olvidó el PIN, restablézcalo en el panel de Meta. ## Mensajes y ventana de atención El canal acepta mensajes de texto, imagen, audio, documento, video, ubicación y plantillas de mensaje. Fuera de la ventana de 24 horas posterior al último mensaje del cliente, WhatsApp no acepta texto libre: use una plantilla aprobada por Meta. > [!WARNING] > > Notfy envía el mensaje, pero Meta puede rechazarlo por reglas del canal, plantilla no aprobada, contenido inválido o falla de medios. Cuando eso ocurra, revise el estado del mensaje en el chat y corrija el contenido o la plantilla. Algunos contactos pueden llegar identificados por un identificador comercial de WhatsApp, sin número de teléfono. Notfy usa esa identidad para ubicar al contacto y responder; por lo tanto, la ausencia de teléfono no significa necesariamente que el mensaje se haya perdido. Si la cuenta tiene más de un número oficial activo, la recepción puede asociarse al primer número activo encontrado para la empresa. Para evitar un enrutamiento inesperado, mantenga activo solo el número necesario o confirme la configuración con el administrador. ## Comportamiento del canal En la sección **Comportamiento Oficial**: | Campo | Descripción | | :- | :- | | **Modo de Atención** | Inteligencia Artificial, o Flujo Fijo (constructor visual, sin IA). Aparece cuando la empresa define la IA por canal | | **Activar IA en este número** | Activa la IA en el número. Usa proveedores de IA en EE. UU. y exige aceptar la transferencia internacional de datos | | **Abrir Editor de Flujo** | Abre el constructor visual, cuando el modo es Flujo Fijo | | **Creación automática de leads** | Crea el lead en el embudo cuando un nuevo contacto escribe | ## Preguntas frecuentes > [accordion] Los mensajes de los clientes no llegan > > Confirme que la URL y el token de verificación fueron pegados en Meta for Developers y que el evento de mensajes está suscrito. Luego haga clic en **Verificar Conexión**. > [accordion] La conexión falló > > Verifique el ID del Número de Teléfono, el ID de la Cuenta de WhatsApp Business y el token. El aviso pide revisar esos datos. > [accordion] No puedo enviar un mensaje a un cliente > > Fuera de la ventana de 24 horas posterior al último mensaje del cliente, solo es posible enviar plantillas de mensaje aprobadas. > [accordion] ¿Puedo enviar audio, documentos o ubicación? > > Sí. El canal admite audio, documentos, imágenes, videos y ubicación, además de texto y plantillas. Meta aún puede aplicar límites y validaciones propios para cada tipo de medio. > [card] [Plantillas de mensaje](https://docs.notfy.ai/es/cadastros/modelos-mensagem.md) > > Cree y siga las plantillas aprobadas. > [card] [Chat de atención](https://docs.notfy.ai/es/atendimento/chat.md) > > Atienda las conversaciones del canal. > [card] [Instagram Direct](https://docs.notfy.ai/es/configuracoes/integracao-instagram.md) > > Conecte también Instagram. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.