API Documentation

Introduzione

La API di WZP Automa ti permette di integrare le funzionalità di automazione WhatsApp nelle tue applicazioni. L'API è basata su REST, usa JSON e richiede autenticazione via API Key.

curl -X POST https://api.wzpautoma.it/v1/messages/send \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "393331234567",
    "message": "Ciao! Benvenuto su WZP Automa"
  }'

Autenticazione

Tutte le richieste API richiedono un API Key passato nell'header Authorization.

Authorization: Bearer YOUR_API_KEY

Ottieni la tua API Key dal pannello admin: Impostazioni > API

Invio Messaggi

Parametri

{
  "success": true,
  "message_id": "wamid.XXXX",
  "status": "sent"
}

Webhook Events

Configura un webhook per ricevere eventi in tempo reale quando arrivano messaggi o cambiano stati.

Eventi Disponibili

• message.received - Nuovo messaggio in arrivo
• message.sent - Messaggio inviato
• message.delivered - Messaggio consegnato
• message.read - Messaggio letto
• contact.created - Nuovo contatto

{
  "event": "message.received",
  "timestamp": "2024-01-15T10:30:00Z",
  "data": {
    "id": "msg_12345",
    "from": "393331234567",
    "text": "Ciao, vorrei info",
    "timestamp": "2024-01-15T10:30:00Z"
  }
}