API Reference v1

Invio Messaggi

Documentazione tecnica per l'endpoint di invio messaggi multicanale (WhatsApp & SMS).

1 Endpoint

POST https://message.app.craon.it/api/client/send-message

2 Headers Richiesti

Key	Value	Descrizione
Content-Type	application/json	Formato del payload
X-Api-Key	[API_KEY_APP]	La tua chiave API segreta

3 Parametri Body

Struttura dettagliata dei parametri accettati nel body della richiesta.

Parametri Root

Parametro	Tipo	Descrizione
serviceType	string	Servizio di invio. Valori: `whatsApp`, `esendex`.
messageTemplateName	string	Nome del template WhatsApp approvato.
disableServiceFallback	boolean	Se `true`, disabilita il fallback su SMS (esendex) in caso di fallimento WhatsApp.
whatsAppHeaderImage	object	Opzionale. Configurazione immagine header. Vedi dettaglio sotto.
whatsAppHeaderParameters	array	Opzionale. Parametri globali per l'header. Vedi dettaglio sotto.
whatsAppBodyParameters	array	Opzionale. Parametri globali per il body. Vedi dettaglio sotto.
recipients	array	Lista dei destinatari. Vedi dettaglio sotto.

whatsAppHeaderImage (Object)

Parametro	Descrizione
link	URL pubblico dell'immagine. Mutualmente esclusivo con `base64`.
base64	Stringa Base64 dell'immagine. Mutualmente esclusivo con `link`.

whatsAppHeaderParameters / whatsAppBodyParameters (Array of Objects)

Parametro	Descrizione
name	Nome del parametro/variabile nel template (es. `{{1}}`).
text	Valore da sostituire.

recipients (Array of Objects)

Parametro	Descrizione
phoneNumber	Numero di telefono completo (es. `+39333...`). Se 10 cifre senza prefisso, default +39.
whatsAppHeaderParameters	Override parametri header specifico per questo destinatario.
whatsAppBodyParameters	Override parametri body specifico per questo destinatario.

Esempio Richiesta

PAYLOAD JSON

{
  "serviceType": "whatsApp",
  "messageTemplateName": "promo_inverno_2024",
  "disableServiceFallback": false,
  "whatsAppHeaderImage": {
    "link": "https://example.com/images/banner.jpg",
    "base64": ""
  },
  "whatsAppHeaderParameters": [
    { "name": "azienda", "text": "Craon" }
  ],
  "whatsAppBodyParameters": [
    { "name": "sconto", "text": "20%" }
  ],
  "recipients": [
    {
      "phoneNumber": "+393331234567",
      "whatsAppHeaderParameters": [
        { "name": "cliente", "text": "Mario" }
      ],
      "whatsAppBodyParameters": [
        { "name": "codice_sconto", "text": "WINTER20" }
      ]
    }
  ]
}

cURL

curl -X POST https://message.app.craon.it/api/client/send-message \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -d '{
    "serviceType": "whatsApp",
    "messageTemplateName": "promo_inverno_2024",
    "recipients": [
      { "phoneNumber": "+393331234567" }
    ]
  }'

JavaScript / Node.js

const response = await fetch('https://message.app.craon.it/api/client/send-message', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-Api-Key': 'YOUR_API_KEY'
  },
  body: JSON.stringify({
    serviceType: 'whatsApp',
    messageTemplateName: 'promo_inverno_2024',
    recipients: [{ phoneNumber: '+393331234567' }]
  })
});

const data = await response.json();
console.log(data);

Hai bisogno di aiuto?

Il nostro team di supporto è disponibile per assisterti nell'integrazione.

Contatta il Supporto