Genuka WA docs

Inviare messaggi

Un solo endpoint che copre tutta la superficie della Cloud API.

POST /api/v1/messages

Un invio contiene sempre tre cose: la connessione da cui inviare, il destinatario ed esattamente un campo di contenuto.

{
  "connectionId": "cnx_...",
  "to": "+237699001122",
  "text": "Hello 👋"
}

Il numero è in formato internazionale. Ottieni connectionId da GET /api/v1/connections. Aggiungi replyTo con il wamid di un messaggio in arrivo per citarlo nella tua risposta.

Campi di contenuto

Un campo alla volta

Inviare due campi di contenuto nella stessa richiesta non invia due messaggi: viene usato solo il primo riconosciuto. Fai due chiamate.

Testo e media

CampoContenutoLimiti
textUna stringa, oppure { body, previewUrl }4096 caratteri
imageJPEG, PNG5 MB, didascalia di 1024 caratteri
videoMP4, 3GPP (H.264 + AAC)16 MB
audioAAC, AMR, MP3, M4A, OGG16 MB, nessuna didascalia
documentPDF, DOC(X), XLS(X), PPT(X), TXT100 MB
stickerWebP statico o animato100 KB / 500 KB

Posizione, contatti, reazione

CampoContenuto
location{ latitude, longitude, name, address }
locationRequest{ body } — mostra un pulsante "Invia posizione"
contactsUn array di schede contatto
reaction{ messageId, emoji } — una stringa vuota rimuove la reazione

Messaggi interattivi

{
  "connectionId": "cnx_...",
  "to": "+237699001122",
  "buttons": {
    "body": "How can we help?",
    "footer": "Genuka",
    "buttons": [
      { "id": "order", "title": "My order" },
      { "id": "support", "title": "A problem" }
    ]
  }
}
CampoDescrizioneLimiti
buttonsPulsanti di risposta rapida3 al massimo, titoli di 20 caratteri
listSezioni e righe10 sezioni, 10 righe in totale
ctaUn unico pulsante con un URLurl + displayText

La risposta dell'utente arriva via webhook, con l'id del pulsante o della riga che ha scelto.

Modelli

Fuori dalla finestra di 24 ore, verrà consegnato solo un modello approvato.

{
  "connectionId": "cnx_...",
  "to": "+237699001122",
  "template": {
    "name": "order_confirmation",
    "language": "en",
    "body": ["Awa", "ORD-1042"]
  }
}

L'invio di un modello apre una conversazione Meta a pagamento sulla WABA del cliente stesso: Meta fattura direttamente il cliente. I messaggi di servizio inviati all'interno della finestra di 24 ore sono gratuiti.

Crea e segui i modelli tramite /api/v1/templates. Un modello in stato PAUSED o REJECTED non può essere usato: controlla il suo stato prima di lanciare una campagna.

Via di fuga

Se un tipo di messaggio non è ancora esposto, raw inoltra così com'è un frammento della Cloud API:

{
  "connectionId": "cnx_...",
  "to": "+237699001122",
  "raw": { "type": "interactive", "interactive": { "type": "flow" } }
}

Su raw non viene applicata alcuna validazione: gli errori tornano da Meta così come sono.

Errori comuni

Codice MetaSignificatoCosa fare
131047Più di 24 h dall'ultimo messaggio in arrivoInvia un modello
131026Destinatario irraggiungibile o non su WhatsAppNon riprovare
131050L'utente si è disiscritto dal marketingNon inviargli mai più marketing
131049Raggiunto il limite di marketing per utenteRiprova più tardi
132001Modello inesistente o non approvato in quella linguaControlla nome e lingua
130429Velocità di invio superataRallenta, riprova con backoff

In questa pagina