All-in-One Messenger Hub
Guida all'integrazione API
Collega il tuo CRM, il tuo sistema di prenotazione o qualsiasi applicazione per inviare messaggi WhatsApp tramite la nostra semplice API.
Inizia in 5 semplici passi
Scarica l'app desktop
Scarica e installa All-in-One Messenger Hub sul tuo computer Windows.
Collega il tuo WhatsApp
Aggiungi il tuo account WhatsApp all'app scansionando il codice QR.
Crea una Session API
Vai alla scheda WhatsApp e crea una nuova Session API. Collegala al tuo canale WhatsApp.
Copia la tua chiave API
Copia la chiave API generata. Tienila al sicuro - e la tua autenticazione.
Inizia a inviare messaggi
Usa l'API dalla tua applicazione. Tieni l'app desktop in esecuzione per consegnare i messaggi.
Autenticazione
Tutti gli endpoint API richiedono l'autenticazione tramite la tua chiave API. Puoi passare la chiave in uno qualsiasi di questi modi:
| Metodo | Esempio |
|---|---|
| Header X-API-Key (consigliato) | X-API-Key: your-api-key |
| Parametro query/body | key=your-api-key |
| Parametro alternativo | api_key=your-api-key |
Invia messaggio
Invia un messaggio WhatsApp a un numero di telefono o a un gruppo. I messaggi vengono messi in coda e consegnati quando l'app desktop e in esecuzione.
POST https://onemessengerhub.com/api/whatsapp-session/sendParametri
| Parametro | Tipo | Richiesto | Descrizione |
|---|---|---|---|
key |
string | Si | La tua chiave API dall'app desktop |
mobile |
string | Condizionale | Numero di telefono con prefisso internazionale (richiesto senza group_id) |
group_id |
string | Condizionale | ID del gruppo WhatsApp (richiesto senza mobile). Il suffisso @g.us viene aggiunto in automatico. |
message |
string | Si | Testo del messaggio (max 4096 caratteri) |
Esempio di richiesta
curl -X POST https://onemessengerhub.com/api/whatsapp-session/send \ -H "X-API-Key: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"mobile": "1234567890", "message": "Hello!"}'Semplice richiesta GET (browser o link)
https://onemessengerhub.com/api/whatsapp-session/send?key=YOUR_API_KEY&mobile=1234567890&message=Hello!Risposta di successo (201)
{ "success": true, "message": "Message queued successfully", "data": { "message_id": 123, "recipient": "1234567890", "status": "pending" }}Salva contatto
Salva o rinomina un contatto nel tuo WhatsApp. L'operazione viene messa in coda ed elaborata dall'app desktop.
POST https://onemessengerhub.com/api/whatsapp-session/save-contactParametri
| Parametro | Tipo | Richiesto | Descrizione |
|---|---|---|---|
key |
string | Si | La tua chiave API dall'app desktop |
contact_id |
string | Si | Numero di telefono del contatto o ID WhatsApp (max 50 caratteri). Il suffisso @c.us viene aggiunto in automatico. |
name |
string | Si | Nome visualizzato per il contatto (max 255 caratteri) |
Esempio di richiesta
curl -X POST https://onemessengerhub.com/api/whatsapp-session/save-contact \ -H "X-API-Key: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"contact_id": "1234567890", "name": "John Doe"}'Risposta di successo (201)
{ "success": true, "message": "Contact save operation queued", "data": { "operation_id": 456, "contact_id": "[email protected]", "status": "pending" }}Rimuovi contatto
Rimuovi un contatto dal tuo WhatsApp. L'operazione viene messa in coda ed elaborata dall'app desktop.
POST https://onemessengerhub.com/api/whatsapp-session/remove-contactParametri
| Parametro | Tipo | Richiesto | Descrizione |
|---|---|---|---|
key |
string | Si | La tua chiave API dall'app desktop |
contact_id |
string | Si | Numero di telefono del contatto o ID WhatsApp (max 50 caratteri). Il suffisso @c.us viene aggiunto in automatico. |
Esempio di richiesta
curl -X POST https://onemessengerhub.com/api/whatsapp-session/remove-contact \ -H "X-API-Key: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"contact_id": "1234567890"}'Risposta di successo (201)
{ "success": true, "message": "Contact remove operation queued", "data": { "operation_id": 789, "contact_id": "[email protected]", "status": "pending" }}Gestione degli errori
L'API usa codici di stato HTTP standard. Ecco le risposte di errore comuni:
Errore di autenticazione (401)
{ "success": false, "message": "Invalid or inactive API key"}Errore di validazione (422)
{ "success": false, "message": "Validation failed", "errors": { "mobile": ["The mobile field is required when group id is not present."], "message": ["The message field is required."] }}Cosa puoi creare
Integrazione con il CRM
Invia messaggi di follow-up, promemoria e aggiornamenti direttamente dal tuo sistema CRM.
Conferme di prenotazione
Invia in automatico conferme di appuntamento e promemoria ai clienti.
Notifiche sugli ordini
Avvisa i clienti sullo stato dell'ordine, sugli aggiornamenti di spedizione e sulle informazioni di consegna.
Sistemi di avviso
Invia avvisi e notifiche importanti al tuo team o ai tuoi clienti.
Campagne di marketing
Invia messaggi promozionali e aggiornamenti alla tua lista di contatti.
Flussi di lavoro personalizzati
Integra con Zapier, Make, n8n o qualsiasi piattaforma di automazione.
Altre API in arrivo
Stiamo ampliando la nostra offerta di API per coprire piu piattaforme e casi d'uso.
API Chatbot
Attiva le risposte del chatbot e gestisci le conversazioni in modo programmatico.
API Contatti
Accedi e gestisci i tuoi contatti di messaggistica su tutte le piattaforme.
Webhook
Ricevi notifiche in tempo reale quando i messaggi vengono ricevuti o inviati.