Documentazione API

Panoramica API

L'API pubblica ti permette di integrare Campaign email, Subscriber, controlli quota, email transazionale, WhatsApp, Facebook, Workspace, allegati, Template e Analytics.

URL base: https://app.infomail.ai/api/v1

Autenticazione

Le integrazioni API supportate utilizzano Bearer Token generati dalla pagina API Token.

Authorization: Bearer YOUR_API_TOKEN

Importante: Questa documentazione documenta intenzionalmente solo l'accesso API basato su Token.

curl -X GET "https://app.infomail.ai/api/v1/subscribers" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"

Gate funzionalità

La maggior parte degli Endpoint dati richiedono la funzionalità del piano api_access.
Gli Endpoint WhatsApp richiedono anche whatsapp.
Gli Endpoint Facebook richiedono anche facebook_ads.
Gli Endpoint di elenco e utilizzo piani rimangono disponibili al di fuori del gate api_access.

Gruppi Endpoint

Campagne

Metodo	Endpoint	Descrizione
GET	`/api/v1/campaigns`	Lista Campaign
POST	`/api/v1/campaigns`	Crea Campaign
GET	`/api/v1/campaigns/{id}`	Mostra Campaign
PUT/PATCH	`/api/v1/campaigns/{id}`	Aggiorna Campaign
DELETE	`/api/v1/campaigns/{id}`	Elimina campagna
POST	`/api/v1/campaigns/{id}/send`	Invia campagna
GET	`/api/v1/campaigns/{id}/stats`	Statistiche Campaign
GET	`/api/v1/campaigns/{id}/messages`	Messaggi Campaign
GET	`/api/v1/campaigns/{id}/export`	Esportazione CSV Campaign
GET	`/api/v1/stats/campaigns`	Tutte le statistiche delle Campaign

Subscriber e quota

Metodo	Endpoint	Descrizione
GET	`/api/v1/subscribers`	Lista Subscriber con campi Bounce e Abuse
POST	`/api/v1/subscribers`	Crea o aggiorna Subscriber per email
GET	`/api/v1/subscribers/{id}`	Mostra Subscriber
GET	`/api/v1/quota`	Stato quota corrente
POST	`/api/v1/quota/check`	Verifica se un volume può essere inviato

Controllo transazionale e Spam

Metodo	Endpoint	Descrizione
POST	`/api/v1/transactional/send`	Invia email transazionale
GET	`/api/v1/transactional/{messageId}`	Stato email transazionale
GET	`/api/v1/transactional/templates/{id}`	Dettagli Template transazionale
POST	`/api/v1/spam-check/analyze`	Analisi Spam completa
POST	`/api/v1/spam-check/quick`	Controllo Spam rapido
GET	`/api/v1/spam-check/status`	Stato servizio controllo Spam

Workspace, campi opzionali, Template e allegati

Gruppo	Endpoint
Workspace	`/api/v1/workspaces`, `/api/v1/workspaces/{id}/users`
Campi opzionali	`/api/v1/optional-fields`
Importazione/esportazione Template	`/api/v1/templates/import`, `/api/v1/templates/{id}/export`, `/api/v1/templates/{id}/content`
Allegati	`/api/v1/attachments`, `/api/v1/attachments/download/{storedName}`

Esempi

Email transazionale

curl -X POST "https://app.infomail.ai/api/v1/transactional/send" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "cliente@example.com",
    "subject": "Conferma ordine #12345",
    "content": "<html><body>Ordine confermato</body></html>",
    "from_email": "ordini@acme.com",
    "from_name": "Acme"
  }'

WhatsApp transazionale

curl -X POST "https://app.infomail.ai/api/v1/transactional/whatsapp/send" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+393331234567",
    "template_id": 12,
    "parameters": {
      "body": ["Mario", "ORD-12345"]
    },
    "reference": "order-12345",
    "idempotency_key": "order-12345-whatsapp"
  }'

Facebook Events

curl -X POST "https://app.infomail.ai/api/v1/facebook/events" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "event_name": "Purchase",
    "user_data": {
      "email": "mario@example.com"
    },
    "custom_data": {
      "value": 79.90,
      "currency": "EUR"
    }
  }'

Contenuto