Integra WhatsApp, SMS
ed Email in pochi minuti
API REST v4 semplici, documentate e pronte per la produzione. JWT Auth, webhook, invio massivo e molto altro.
- Autenticazione JWT Bearer sicura
- Webhook in tempo reale per tutti gli eventi
- Sandbox gratuito — nessuna carta di credito
- Documentazione OpenAPI 3.0 completa
Integra in 3 passaggi
Da zero a messaggi inviati in meno di 10 minuti.
Genera il token
Chiama l'endpoint di autenticazione con le tue credenziali per ottenere un token JWT da usare in tutte le richieste.
{"username":"...","password":"..."}
→ {"token": "eyJh..."}
Invia il primo messaggio
Usa il token nell'header Authorization e chiama l'endpoint per inviare un messaggio WhatsApp, SMS o Email.
Authorization: Bearer <token>
→ {"status": "sent"}
Ricevi gli eventi
Configura un webhook per ricevere in tempo reale messaggi in arrivo, conferme di consegna e aggiornamenti di stato.
"url": "https://your-app.com/hook"
→ {"status": "active"}
Autenticazione JWT Bearer
Tutte le API Chat API utilizzano token JWT. Genera il tuo token con una singola chiamata POST e includilo nell'header Authorization di ogni richiesta.
Scadenza configurabile
I token scadono dopo un periodo configurabile. Rigenera automaticamente via API senza interruzioni.
HTTPS obbligatorio
Tutte le comunicazioni avvengono su HTTPS con TLS 1.2+. Nessuna chiamata in chiaro accettata.
Credenziali sicure
Username e password vengono scambiate una sola volta per ottenere il token da usare nelle API.
{
"username": "your@email.com",
"password": "your-password"
}{
"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6Ikp...",
"expiresIn": 3600,
"type": "Bearer"
}Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6Ikp...Tutti gli endpoint disponibili
Ogni endpoint è documentato con parametri, risposte ed esempi nella nostra documentazione OpenAPI.
Invia messaggio
/api/v4/whatsapp/chats/{id}/message Invia un messaggio WhatsApp diretto
Lista template
/api/v4/notifications/whatsapp/templates Visualizza i template approvati
Notifica template
/api/v4/whatsapp/notifications Invia notifica one-to-one fuori 24h
Invio massivo
/api/v4/whatsapp/bulk Invia a migliaia di contatti in batch
Invia SMS
/api/v4/sms/send Invia un SMS a qualsiasi numero mondiale
Campagna SMS
/api/v4/sms/bulk Invio massivo a liste di contatti
Report consegna
/api/v4/sms/reports/{id} Verifica lo stato di consegna
Invia email
/api/v4/email/send Email transazionale con DKIM/SPF
Campagna email
/api/v4/email/bulk Invio campagne marketing in bulk
Eventi email
/api/v4/email/events Open rate, click, bounce, unsubscribe
Autenticazione
/api/v4/auth/token Genera token JWT Bearer
Webhook
/api/v4/webhooks/create Configura ricezione eventi in tempo reale
Chat Widget
/api/v4/iframes/whatsapp/chat-box Genera un iframe per la chat WhatsApp
Integra nel tuo linguaggio
Esempi pronti all'uso per autenticarti e inviare il tuo primo messaggio.
curl -X POST \
https://app.roxpay.eu/api/v4/auth/token \
-H "Content-Type: application/json" \
-d '{"username":"...","password":"..."}'
# Usa il token:
curl -X POST \
.../whatsapp/chats/123/message \
-H "Authorization: Bearer <token>" \
-d '{"body":"Ciao!"}'import requests
# Autenticazione
r = requests.post(
"https://app.roxpay.eu/api/v4/auth/token",
json={"username":"...", "password":"..."}
)
token = r.json()["token"]
# Invia messaggio
requests.post(
"...whatsapp/chats/123/message",
headers={"Authorization": f"Bearer {token}"},
json={"body": "Ciao!"}
)// Autenticazione
const r = await fetch(
"https://app.roxpay.eu/api/v4/auth/token",
{ method: "POST",
headers: {"Content-Type":"application/json"},
body: JSON.stringify({username,password}) }
);
const { token } = await r.json();
// Invia messaggio
await fetch("...chats/123/message", {
method: "POST",
headers: { Authorization: `Bearer ${token}` },
body: JSON.stringify({ body: "Ciao!" })
});Sandbox e produzione
Testa liberamente nell'ambiente sandbox senza costi, poi passa alla produzione con un solo cambio di URL. Zero refactoring.
Sandbox gratuito
Nessun credito consumato. Messaggi simulati. Test illimitati senza configurazione aggiuntiva.
Produzione scalabile
Infrastruttura enterprise con SLA 99.9% e supporto tecnico dedicato.
Cambio istantaneo
Cambia solo il base URL per passare da sandbox a produzione. Stesso codice, stesso contratto API.
Base URL
https://sandbox.roxpay.eu ✓ Messaggi simulati · ✓ Nessun costo · ✓ Dati di test
Base URL
https://app.roxpay.eu ✓ Messaggi reali · ✓ SLA 99.9% · ✓ Supporto dedicato
Documentazione completa disponibile
Tutti i parametri, gli schemi di risposta, i codici di errore e gli esempi interattivi nell'interfaccia Swagger.