Template

Per scrivere a un destinatario fuori dalla finestra di 24 ore serve un template approvato da Meta. I template appartengono all'account WhatsApp del cliente: ogni cliente ha i suoi.

Creare un template

curl -X POST https://api.depalmalabs.it/v1/customers/cus_xxxxxxxxxxxx/templates \
  -H "Authorization: Bearer $DPL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "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"]] }
    }]
  }'

Lo stato iniziale è PENDING; l'esito (di solito entro pochi minuti, a volte fino a 24 ore) arriva con l'evento template.status. Con chiave sandbox il template è solo locale e risulta subito APPROVED.

Categorie

• UTILITY: aggiornamenti legati a qualcosa che il destinatario ha fatto o chiesto (appuntamento, ordine, fattura).
• MARKETING: promozioni, offerte, newsletter. Vanno in pausa automatica se la qualità del numero scende a RED.
• AUTHENTICATION: codici monouso. Testo fisso definito da Meta, con pulsante per copiare il codice.

Meta può riclassificare un template (per esempio da UTILITY a MARKETING) se il contenuto è promozionale: il prezzo segue la categoria finale.

Regole che evitano il rifiuto

• Nome in minuscolo con underscore (conferma_ordine), unico per lingua.
• Variabili numerate in ordine da {{1}}, con un esempio per ciascuna in example.body_text.
• Il corpo non può iniziare o finire con una variabile, né avere due variabili attaccate.
• Niente contenuti vietati dalle policy di Meta (vedi la nostra policy d'uso).

Inviare

Il modo più semplice è variables (corpo) e header_variables (intestazione testo). Per media in intestazione o pulsanti usa components nel formato Cloud API: trovi gli esempi in Esempi pronti.

Elencare e cancellare

GET /v1/customers/{id}/templates restituisce stato e motivo dell'eventuale rifiuto. DELETE /v1/customers/{id}/templates?name=…&language=it lo rimuove anche da Meta.