Riferimento API

post/v1/messages

Invia un messaggio

Testo (solo entro 24 ore dall'ultimo messaggio del destinatario), template approvato o media (link https). Header opzionale `Idempotency-Key`: la stessa chiave con lo stesso corpo restituisce il messaggio già creato (200, header `Idempotent-Replayed: true`). Risposta 202: esito presso Meta non confermato (timeout): non riprovare alla cieca, lo stato arriverà via webhook.

• Idempotency-Key (header)

{
  "customer_id": "cus_xxxxxxxx",
  "to": "+393331234567",
  "type": "template",
  "template": {
    "name": "promemoria_appuntamento",
    "language": "it",
    "variables": [
      "Maria",
      "domani alle 10:00"
    ]
  }
}

{
  "customer_id": "cus_xxxxxxxx",
  "to": "+393331234567",
  "type": "text",
  "text": {
    "body": "Grazie, a domani!"
  }
}

{
  "customer_id": "cus_xxxxxxxx",
  "to": "+393331234567",
  "type": "document",
  "media": {
    "link": "https://esempio.it/fattura-123.pdf",
    "filename": "Fattura 123.pdf",
    "caption": "La tua fattura"
  }
}

get/v1/messages/{id}

Stato di un messaggio

• id (path, obbligatorio) — Id della piattaforma (msg_…) o wamid di Meta

get/v1/customers

Elenco clienti

post/v1/customers

Crea un cliente

{
  "name": "Centro Estetico Luna",
  "external_ref": "CLI-042"
}

get/v1/customers/{id}

Dettaglio cliente

• id (path, obbligatorio) — Id cliente (cus_…)

post/v1/customers/{id}/onboarding-link

Link di onboarding per il cliente finale

Solo chiavi live e account approvato. Il link vale 14 giorni e sostituisce il precedente.

• id (path, obbligatorio) — Id cliente (cus_…)

get/v1/customers/{id}/templates

Template del cliente

• id (path, obbligatorio) — Id cliente (cus_…)

post/v1/customers/{id}/templates

Crea un template

Inviato a Meta per l'approvazione. Regole: corpo senza variabile all'inizio o alla fine, variabili numerate da {{1}}, esempi in example.body_text. Con chiave sandbox il template è solo locale e risulta subito APPROVED.

• id (path, obbligatorio) — Id cliente (cus_…)

{
  "name": "promemoria_appuntamento",
  "language": "it",
  "category": "UTILITY",
  "components": [
    {
      "type": "BODY",
      "text": "Ciao {{1}}, ti ricordiamo l'appuntamento di {{2}}. A presto!",
      "example": {
        "body_text": [
          [
            "Maria",
            "domani alle 10:00"
          ]
        ]
      }
    }
  ]
}

delete/v1/customers/{id}/templates

Cancella un template per nome

• id (path, obbligatorio) — Id cliente (cus_…)
• name (query, obbligatorio)
• language (query)

put/v1/customers/{id}/webhook

Imposta il webhook del cliente

URL https pubblico (porte 443 o 8443). `url: null` disattiva. Il secret di firma è restituito alla prima configurazione o con `rotate_secret: true`.

• id (path, obbligatorio) — Id cliente (cus_…)

{
  "url": "https://tuo-gestionale.it/whatsapp/webhook"
}

get/v1/usage

Consumi del mese

Solo messaggi che Meta segna come a pagamento. Fee De Palma Labs più stima del costo Meta (pagato direttamente dal cliente finale).

• month (query) — YYYY-MM (default mese corrente, fuso Europe/Rome)