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

# Introducción

> Bienvenido a la API de Whaapy - Automatiza WhatsApp Business de forma simple

# Bienvenido a Whaapy API

Whaapy es una plataforma que te permite **automatizar WhatsApp Business** de manera simple y poderosa. Con nuestra API puedes enviar mensajes, gestionar conversaciones y crear experiencias increíbles para tus clientes.

<Info>
  **Formato Híbrido**: Nuestra API es compatible con Meta WhatsApp Cloud API, lo que facilita la migración desde otras plataformas.
</Info>

***

## ¿Qué puedes hacer con Whaapy?

<CardGroup cols={2}>
  <Card title="Enviar Mensajes" icon="paper-plane" href="/api-reference/messages/send">
    Texto, imágenes, videos, documentos, templates, botones y más
  </Card>

  <Card title="Automatizar Respuestas" icon="robot" href="/concepts/ai-agent">
    Configura un agente de IA con Control, Knowledge, Tools, Subagents y MCPs
  </Card>

  <Card title="Crear Automatizaciones" icon="bolt" href="/concepts/automations">
    Crea reglas para tags, funnels, mensajes, Meta Leads, webhooks y handoff
  </Card>

  <Card title="Gestionar Conversaciones" icon="messages" href="/api-reference/overview">
    Accede al historial completo de conversaciones
  </Card>

  <Card title="Recibir Webhooks" icon="bolt" href="/api-reference/webhooks/overview">
    Notificaciones en tiempo real de nuevos mensajes
  </Card>
</CardGroup>

***

## Cómo Funciona

```mermaid theme={null}
sequenceDiagram
    participant App as Tu Aplicación
    participant Whaapy as Whaapy API
    participant Meta as Meta/WhatsApp
    participant User as Usuario

    App->>Whaapy: POST /messages/v1
    Whaapy->>Meta: Enviar mensaje
    Meta->>User: Mensaje de WhatsApp
    User-->>Meta: Respuesta
    Meta-->>Whaapy: Webhook
    Whaapy-->>App: Webhook (mensaje recibido)
```

***

## Tipos de Mensajes Soportados

Whaapy soporta todos los tipos de mensaje de WhatsApp Business:

<CardGroup cols={3}>
  <Card title="Texto" icon="font" href="/api-reference/messages/send">
    Mensajes simples
  </Card>

  <Card title="Imagen" icon="image" href="/api-reference/messages/send-media">
    JPEG, PNG, WebP
  </Card>

  <Card title="Video" icon="video" href="/api-reference/messages/send-media">
    MP4 hasta 16MB
  </Card>

  <Card title="Audio" icon="volume-high" href="/api-reference/messages/send-media">
    MP3, OGG, AAC
  </Card>

  <Card title="Documento" icon="file" href="/api-reference/messages/send-media">
    PDF, Word, Excel
  </Card>

  <Card title="Template" icon="table-layout" href="/api-reference/messages/send-templates">
    Pre-aprobados por Meta
  </Card>

  <Card title="Botones" icon="hand-pointer" href="/api-reference/messages/send-interactive">
    Hasta 3 opciones
  </Card>

  <Card title="Listas" icon="list" href="/api-reference/messages/send-interactive">
    Menús desplegables
  </Card>

  <Card title="Ubicación" icon="location-dot" href="/api-reference/messages/send-location">
    Coordenadas GPS
  </Card>

  <Card title="Contactos" icon="address-book" href="/api-reference/messages/send-contacts">
    Tarjetas vCard
  </Card>

  <Card title="Stickers" icon="note-sticky" href="/api-reference/messages/send-media">
    WebP animados
  </Card>

  <Card title="Reacciones" icon="face-smile" href="/api-reference/messages/send-reactions">
    Emojis en mensajes
  </Card>
</CardGroup>

***

## Empezar es Fácil

<Steps>
  <Step title="Crea una cuenta">
    Regístrate en [app.whaapy.com](https://app.whaapy.com/register) y conecta tu número de WhatsApp Business
  </Step>

  <Step title="Obtén tu API Key">
    Ve a **Configuración** → **API Keys** y genera una nueva clave
  </Step>

  <Step title="Envía tu primer mensaje">
    Usa nuestra API para enviar un mensaje de prueba
  </Step>
</Steps>

***

## Ejemplo Rápido

Envía tu primer mensaje con una sola llamada:

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST https://api.whaapy.com/messages/v1 \
    -H "Authorization: Bearer wha_TU_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "to": "+5215512345678",
      "content": "¡Hola desde Whaapy!"
    }'
  ```

  ```javascript Node.js theme={null}
  const response = await fetch('https://api.whaapy.com/messages/v1', {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer wha_TU_API_KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      to: '+5215512345678',
      content: '¡Hola desde Whaapy!'
    })
  });

  console.log(await response.json());
  ```

  ```python Python theme={null}
  import requests

  response = requests.post(
      'https://api.whaapy.com/messages/v1',
      headers={
          'Authorization': 'Bearer wha_TU_API_KEY',
          'Content-Type': 'application/json'
      },
      json={
          'to': '+5215512345678',
          'content': '¡Hola desde Whaapy!'
      }
  )

  print(response.json())
  ```
</CodeGroup>

<Tip>
  El formato simplificado de Whaapy (`content`) te ahorra líneas de código. También soportamos el formato completo de Meta para compatibilidad.
</Tip>

***

## Formato Híbrido

Nuestra API acepta **dos estilos** de request:

<Tabs>
  <Tab title="Estilo Whaapy">
    Formato simplificado para casos comunes:

    ```json theme={null}
    {
      "to": "+5215512345678",
      "content": "Hola!"
    }
    ```
  </Tab>

  <Tab title="Estilo Meta">
    100% compatible con WhatsApp Cloud API:

    ```json theme={null}
    {
      "messaging_product": "whatsapp",
      "to": "+5215512345678",
      "type": "text",
      "text": { "body": "Hola!" }
    }
    ```
  </Tab>
</Tabs>

Esto facilita la migración si ya tienes código funcionando con la API oficial de Meta.

***

## ¿Necesitas Ayuda?

<CardGroup cols={3}>
  <Card title="Documentación" icon="book" href="/quickstart">
    Guía paso a paso
  </Card>

  <Card title="API Reference" icon="code" href="/api-reference/overview">
    Referencia completa
  </Card>

  <Card title="Soporte" icon="headset" href="mailto:soporte@whaapy.com">
    Contacta al equipo
  </Card>
</CardGroup>

***

## Próximos Pasos

<CardGroup cols={2}>
  <Card title="Quickstart" icon="rocket" href="/quickstart">
    Envía tu primer mensaje en 5 minutos
  </Card>

  <Card title="Agente IA" icon="robot" href="/concepts/colme-2">
    Entiende colme-2 y configura el agente de Whaapy
  </Card>

  <Card title="Automatizaciones" icon="bolt" href="/concepts/automations">
    Diseña flujos automáticos desde el dashboard
  </Card>

  <Card title="Autenticación" icon="key" href="/api-reference/authentication">
    Configura tu API Key
  </Card>
</CardGroup>