# Guida rapida

URL: https://wa.genuka.com/it/docs/quickstart
Language: Italian

> Dalla registrazione al tuo primo messaggio, in una decina di minuti.

1. ### Crea il tuo account

   Registrati con il nome della tua azienda, un'email e una password. Il tuo spazio di lavoro si apre
   con una prova gratuita di 7 giorni: un numero WhatsApp, la sua quota completa di messaggi, API REST
   e webhook inclusi. Nessuna carta richiesta.

2. ### Collega il tuo numero WhatsApp

   Dalla tua dashboard, apri **Connessioni**. Lì trovi un URL unico. Aprilo per collegare il tuo
   numero tramite l'Embedded Signup di Meta, oppure invialo a un'azienda di cui gestisci i numeri.

   L'account, i suoi numeri e i suoi modelli compaiono quindi automaticamente nel tuo spazio di lavoro.

   > [!NOTE]
   > **Usi già l'app WhatsApp Business?**
   >
   > Puoi tenere l'app sul telefono e collegare l'API allo stesso numero: è la modalità
   > **coesistenza**. Le tue conversazioni restano sincronizzate in entrambe le direzioni. L'unica
   > differenza da conoscere: la velocità di invio è limitata a 20 messaggi al secondo.

3. ### Crea una chiave API

   Sempre nella dashboard, in **Sviluppatori**, genera una chiave. Viene mostrata **una sola volta**:
   copiala subito.

4. ### Invia il tuo primo messaggio

   Per prima cosa, recupera la connessione da cui vuoi inviare:

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

   Poi invia:

   ```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]
   > Questo primo invio funziona solo se il destinatario ti ha scritto nelle ultime **24 ore**.
   > Altrimenti ti serve un modello approvato: vedi [Inviare messaggi](https://wa.genuka.com/it/docs/messages).

5. ### Ricevi le risposte

   Nel portale, in **Webhook**, registra l'URL della tua applicazione e scegli gli eventi che vuoi
   ricevere. Il segreto di firma viene mostrato **una sola volta**: copialo.

   Ogni consegna è firmata; il tuo endpoint deve verificare quella firma prima di elaborare qualsiasi
   cosa. Vedi [Webhook](https://wa.genuka.com/it/docs/webhooks).

## Passi successivi

* [Autenticazione](https://wa.genuka.com/it/docs/authentication) — chiavi API, ambito, rotazione.
* [Inviare messaggi](https://wa.genuka.com/it/docs/messages) — tutti i tipi disponibili e la regola delle 24 ore.
* [Webhook](https://wa.genuka.com/it/docs/webhooks) — eventi, firma, reinvio.
