# Inicio rápido

URL: https://wa.genuka.com/es/docs/quickstart
Language: Spanish

> Del registro a tu primer mensaje, en unos diez minutos.

1. ### Crea tu cuenta

   Regístrate con el nombre de tu empresa, un correo electrónico y una contraseña. Tu espacio de
   trabajo se abre con una prueba gratuita de 7 días: un número de WhatsApp, su cuota completa de
   mensajes, la API REST y los webhooks incluidos. No se requiere tarjeta.

2. ### Conecta tu número de WhatsApp

   Desde tu panel, abre **Conexiones**. Ahí encontrarás una URL única. Ábrela para conectar tu propio
   número mediante el Embedded Signup de Meta, o envíala a una empresa cuyos números gestionas.

   La cuenta, sus números y sus plantillas aparecen entonces automáticamente en tu espacio de trabajo.

   > [!NOTE]
   > **¿Ya usas la app WhatsApp Business?**
   >
   > Puedes conservar la app en tu teléfono y conectar la API al mismo número: es el modo de
   > **coexistencia**. Tus conversaciones se mantienen sincronizadas en ambos sentidos. La única
   > diferencia que debes conocer: el ritmo de envío está limitado a 20 mensajes por segundo.

3. ### Crea una clave API

   Todavía en el panel, en **Desarrolladores**, genera una clave. Se muestra **una sola vez**: cópiala
   de inmediato.

4. ### Envía tu primer mensaje

   Primero, consulta la conexión desde la que quieres enviar:

   ```bash
   curl https://wa.genuka.com/api/v1/connections \
     -H "Authorization: Bearer $GENUKA_WA_API_KEY"
   ```

   Luego envía:

   ```bash
   curl https://wa.genuka.com/api/v1/messages \
     -H "Authorization: Bearer $GENUKA_WA_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
       "connectionId": "cnx_...",
       "to": "+237699001122",
       "text": "Hello from Genuka WA 👋"
     }'
   ```

   > [!WARNING]
   > Este primer envío solo funciona si el destinatario te escribió en las últimas **24 horas**.
   > De lo contrario, necesitas una plantilla aprobada: consulta [Enviar mensajes](https://wa.genuka.com/es/docs/messages).

5. ### Recibe respuestas

   En el portal, en **Webhooks**, registra la URL de tu aplicación y elige los eventos que quieres
   recibir. El secreto de firma se muestra **una sola vez**: cópialo.

   Cada entrega está firmada; tu endpoint debe verificar esa firma antes de procesar cualquier cosa.
   Consulta [Webhooks](https://wa.genuka.com/es/docs/webhooks).

## Siguientes pasos

* [Autenticación](https://wa.genuka.com/es/docs/authentication) — claves API, alcance, rotación.
* [Enviar mensajes](https://wa.genuka.com/es/docs/messages) — todos los tipos disponibles y la regla de las 24 horas.
* [Webhooks](https://wa.genuka.com/es/docs/webhooks) — eventos, firma, reenvío.
