Vai al contenuto

API WaliChat + webhook

Il tuo sistema invia.Il team conserva la chat.

Invia messaggi, ricevi eventi e assegna conversazioni con l’API WaliChat. Il risultato compare dove il team lavora già.

Accesso API in WaliChat. Rispetta le regole dei messaggi e i limiti del piano.

REST API
POST /v1/messages
  1. Il tuo sistemaPrepara il messaggio
  2. REST APIPOST /v1/messages
  3. WaliChatVisibile nella chat

Il tuo ordine è pronto per il ritiro.

Richiesta accettata · consegna seguita separatamente

Uno sviluppatore indipendente esamina un'integrazione nel patio di un bar.

Il team vede il messaggio in uscita.

Invia un aggiornamento dell’ordine

Ricevi un evento in entrata

Assegna la chat a Sara

Dalla richiesta all’inbox del team.

Tre attività collegate: inviare, ricevere e assegnare.

Scorri per vedere gli esempi

Invia un aggiornamento dell’ordine

POST /v1/messages

Indica dispositivo collegato, destinatario e messaggio. Usa un modello approvato quando l’API ufficiale lo richiede.

REST API
POST /v1/messages
  1. Il tuo sistemaPrepara il messaggio

    device + phone + message

  2. REST APIPOST /v1/messages

    Autentica con la chiave API.

  3. WaliChatVisibile nella chat

    Il team vede il messaggio in uscita.

Il tuo ordine è pronto per il ritiro.

Richiesta accettata · consegna seguita separatamente

Una richiesta accettata non garantisce la consegna. Controlla gli eventi di stato e gestisci gli errori nel sistema.

Ricevi un evento in entrata

Posso ritirare il mio ordine domani?

Configura un webhook HTTPS e sottoscrivi l’evento di messaggio in entrata.

Webhook

Posso ritirare il mio ordine domani?

  1. WhatsAppMessaggio ricevuto

    Il cliente scrive al numero collegato.

  2. Webhookmessage:in:new

    L’evento raggiunge l’endpoint HTTPS.

  3. Il tuo gestoreScegli l’azione successiva

    Leggi, elabora e decidi cosa fare.

message:in:new

Webhook inviato all’endpoint configurato

Il tuo sistema sceglie il passo successivo. Ricevere un evento non invia automaticamente una risposta.

Assegna la chat a Sara

PATCH /v1/chat/{device}/chats/{chat}/owner

Indica un agente o reparto autorizzato. I reparti dipendono dal piano.

REST API
PATCH /v1/chat/{device}/chats/{chat}/owner
  1. Il tuo sistemaScegli il responsabile

    agent / email / department

  2. REST APIPATCH …/owner

    Aggiorna il responsabile della conversazione.

  3. WaliChatPassa la chat a Sara

    Sara continua con il contesto esistente.

Conversazione assegnata

Sara è responsabile della chat

Assegnazioni e note organizzano il team; non inviano messaggi al cliente.

Scegli l’interfaccia per l’attività.

Usa il backend, un flusso o un client IA compatibile.

REST API

Leggi e aggiorna tramite endpoint JSON documentati.

Webhooks

Ricevi gli eventi sottoscritti nel tuo gestore HTTPS.

MCP

La tua IA, collegata al tuo business.

Le azioni API usano l’autorità della chiave e i limiti del piano. Restano valide regole e tariffe Meta.

Consulta la documentazione API

Una chiave. Un test. Il primo evento.

Inizia dalla documentazione con un numero di test collegato e verifica ogni risposta.

  1. Crea una chiave API

    Usa un account autorizzato per il numero e conserva la chiave nel backend.

  2. Prova la richiesta

    Usa documentazione e tester API con i tuoi dati di prova.

  3. Gestisci eventi ed errori

    Configura i webhook e verifica codici di risposta, limiti e stati di consegna.

Prima di iniziare

  • Un account WaliChat con un numero collegato e accesso API.
  • Un endpoint HTTPS per i webhook sottoscritti.
Due sviluppatori lavorano su un portatile in uno spazio di coworking di quartiere.
Sara · WaliChat

Ho la chat e la nota. Continuo io.

Quando serve una persona, il team ha la chat.

Prepara il passaggio per le eccezioni. Il team vede cosa è successo e continua con il cliente.

Scopri come lavora il team

Una conversazioneCon i messaggi inviati

Un responsabileAssegnata alla persona giusta

Le tue regole di accessoRuoli e accesso al numero

Prima della prima richiesta API.

Una richiesta accettata significa consegna?

No. Controlla eventi di stato e risposta documentata. Il sistema deve gestire errori e tentativi successivi.

Cosa succede fuori dalla finestra di assistenza WhatsApp?

L’API ufficiale WhatsApp mantiene le sue regole. Fuori dalla finestra di assistenza usa un modello approvato e rispetta regole e costi applicabili ai messaggi.

Prepara il flusso. Continua con il tuo business.

Inizia gratis

Inizia con WaliChat e scegli un piano con Flows.