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

# Empieza Aquí

> API potente para la gestión de instancias y automatizaciones en WhatsApp. Conéctese, envíe mensajes y gestione eventos fácilmente.

{document.querySelectorAll("#footer a").forEach((a) => a.remove())}

<Note>
  **Base URL:** `https://api.wppfy.com`
</Note>

## <Icon icon="robot" size={22} /> Documentación para IA

¿Va a integrar usando un asistente de código? Elija su herramienta, copie el prompt y péguelo en el chat. El prompt dirige a la IA al índice de la documentación en [`llms.txt`](https://docs.wppfy.com/llms.txt) (versión completa en [`llms-full.txt`](https://docs.wppfy.com/llms-full.txt)).

<CodeGroup>
  ```text Claude Code icon="https://www.google.com/s2/favicons?domain=claude.ai&sz=64" wrap theme={null}
  Voy a integrar la API de WhatsApp de WppFy en este proyecto.
  Antes de escribir código, lea la documentación en https://docs.wppfy.com/llms.txt y abra las páginas .md de los endpoints que sean necesarios.

  Reglas:
  - Base URL: https://api.wppfy.com
  - Autenticación: header `token` con el token de la instancia, leído de una variable de entorno (WPPFY_TOKEN), nunca fijo en el código.
  - Siga exactamente los payloads y respuestas de la documentación; no invente campos ni endpoints.
  - Maneje los errores HTTP (401, 404, 429, 500) y el estado de la instancia (disconnected, connecting, connected).

  Tarea: [describa aquí lo que desea construir]
  ```

  ```text Codex icon="https://www.google.com/s2/favicons?domain=openai.com&sz=64" wrap theme={null}
  Contexto: integración con la API de WhatsApp de WppFy.
  Documentación (índice para LLMs): https://docs.wppfy.com/llms.txt
  Documentación completa: https://docs.wppfy.com/llms-full.txt

  Lea la documentación antes de implementar. Use la Base URL https://api.wppfy.com y envíe el header `token` con el token de la instancia proveniente de la variable de entorno WPPFY_TOKEN. Use solo endpoints y campos documentados, maneje los errores HTTP y escriba pruebas para las llamadas principales.

  Tarea: [describa aquí lo que desea construir]
  ```

  ```text Cursor icon="https://www.google.com/s2/favicons?domain=cursor.com&sz=64" wrap theme={null}
  @https://docs.wppfy.com/llms.txt

  Use la documentación de WppFy anterior como referencia para integrar la API de WhatsApp en este proyecto.
  - Base URL: https://api.wppfy.com
  - Header de autenticación: `token` (token de la instancia, mediante la variable de entorno WPPFY_TOKEN)
  - Consulte las páginas .md listadas en llms.txt para obtener los payloads exactos de cada endpoint.
  - No invente campos; maneje los errores y el estado de conexión de la instancia.

  Tarea: [describa aquí lo que desea construir]
  ```

  ```text Replit icon="https://www.google.com/s2/favicons?domain=replit.com&sz=64" wrap theme={null}
  Cree una integración con la API de WhatsApp de WppFy.
  Documentación: https://docs.wppfy.com/llms.txt (léala antes de empezar).

  - Base URL: https://api.wppfy.com
  - Guarde el token de la instancia en los Secrets de Replit como WPPFY_TOKEN y envíelo en el header `token`.
  - Para recibir mensajes, exponga una ruta de webhook (POST) y registre los eventos recibidos.
  - Use solo endpoints y campos que estén en la documentación.

  Tarea: [describa aquí lo que desea construir]
  ```

  ```text Lovable icon="https://www.google.com/s2/favicons?domain=lovable.dev&sz=64" wrap theme={null}
  Quiero agregar el envío y la recepción de mensajes de WhatsApp a mi app usando la API de WppFy.
  Lea la documentación en https://docs.wppfy.com/llms.txt antes de implementar.

  - Base URL: https://api.wppfy.com
  - El token de la instancia es secreto: guárdelo como secret (WPPFY_TOKEN) y realice las llamadas desde el backend (Edge Function), nunca directamente desde el navegador.
  - Envíe el token en el header `token`.
  - Siga los payloads exactamente como en la documentación.

  Tarea: [describa aquí lo que desea construir]
  ```

  ```text Bolt.new icon="https://www.google.com/s2/favicons?domain=bolt.new&sz=64" wrap theme={null}
  Integre la API de WhatsApp de WppFy en esta app.
  Documentación de referencia: https://docs.wppfy.com/llms.txt

  - Base URL: https://api.wppfy.com
  - Header `token` con el token de la instancia, leído de una variable de entorno (WPPFY_TOKEN) en un endpoint de servidor; no exponga el token en el front-end.
  - Use solo endpoints y campos documentados y maneje los errores devueltos por la API.

  Tarea: [describa aquí lo que desea construir]
  ```

  ```text v0 icon="https://www.google.com/s2/favicons?domain=v0.app&sz=64" wrap theme={null}
  Construya la integración con la API de WhatsApp de WppFy.
  Documentación: https://docs.wppfy.com/llms.txt

  - Base URL: https://api.wppfy.com
  - Realice las llamadas desde el servidor, con el token de la instancia en una variable de entorno (WPPFY_TOKEN) enviado en el header `token`.
  - Nunca exponga el token en el client.
  - Siga los payloads de la documentación sin inventar campos.

  Tarea: [describa aquí lo que desea construir]
  ```
</CodeGroup>

## <Icon icon="triangle-exclamation" size={22} /> Recomendación Importante

<Warning>
  **Use WhatsApp Business**

  Se recomienda encarecidamente utilizar cuentas de **WhatsApp Business** para evitar desconexiones, limitaciones de envío e inestabilidad en la conexión.
</Warning>

## Autenticación

Para interactuar con la API, deberá configurar los *Headers* de sus solicitudes. Elija el tipo de acceso necesario:

<CodeGroup>
  ```bash Token de la Instancia theme={null}
  # Header para rotas de envio e controle de sessão
  token: SEU_TOKEN_AQUI
  ```
</CodeGroup>

## Estados de la Sesión

Conozca el significado de cada estado de conexión para monitorear sus instancias en tiempo real.

<CardGroup cols={3}>
  <Card title="Desconectado" icon="circle-xmark" color="#ef4444">
    La instancia está totalmente desconectada del servidor de WhatsApp.
  </Card>

  <Card title="Conectando" icon="rotate" color="#eab308">
    El sistema está intentando establecer el handshake con WhatsApp.
  </Card>

  <Card title="Conectado" icon="circle-check" color="#22c55e">
    Conexión estable. La instancia está lista para enviar y recibir datos.
  </Card>
</CardGroup>


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