Guida rapida
Dalla registrazione al tuo primo messaggio, in una decina di minuti.
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.
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.
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.
Crea una chiave API
Sempre nella dashboard, in Sviluppatori, genera una chiave. Viene mostrata una sola volta: copiala subito.
Invia il tuo primo messaggio
Per prima cosa, recupera la connessione da cui vuoi inviare:
curl https://wa.genuka.com/api/v1/connections \
-H "Authorization: Bearer $GENUKA_WA_API_KEY"Poi invia:
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 👋"
}'Questo primo invio funziona solo se il destinatario ti ha scritto nelle ultime 24 ore. Altrimenti ti serve un modello approvato: vedi Inviare messaggi.
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.
Passi successivi
- Autenticazione — chiavi API, ambito, rotazione.
- Inviare messaggi — tutti i tipi disponibili e la regola delle 24 ore.
- Webhook — eventi, firma, reinvio.