API REST · messaggi

POST https://api.pulpo.chat/v1/messages
Token: TU_CLAVE_DE_API
Content-Type: application/json

{
  "phone": "+14155550187",
  "message": "Il tuo ordine è pronto per il ritiro in negozio."
}

Messaggio creato · 201

HTTP/1.1 201 Created
{"id":"ID_MENSAJE_DE_EJEMPLO"}

API WhatsApp per il tuo sistema

Il tuo sistema avvisa.Il tuo team continua il dialogo.

Quando un ordine è pronto, il tuo sistema può creare il messaggio. Il team continua la conversazione in Pulpo.

Inizia gratis Scoprilo in azione

Dati fittizi. Usa un account autorizzato, un numero operativo e le condizioni di invio applicabili.

Richiesta, evento e modello.

Esempi di operazioni documentate. Consulta lo schema completo e prova con il tuo account prima di integrare.

L'ordine è pronto

Creare un messaggio

Avvisare che l'ordine può essere ritirato.

Il tuo server usa l'header Token e il corpo della richiesta. Il destinatario e il testo di questo esempio sono fittizi.

PulpoChatAPI REST · messaggi

Richiesta di esempio

POST https://api.pulpo.chat/v1/messages
Token: TU_CLAVE_DE_API
Content-Type: application/json

{
  "phone": "+14155550187",
  "message": "Il tuo ordine è pronto per il ritiro in negozio."
}

Messaggio creato · 201

HTTP/1.1 201 Created
{"id":"ID_MENSAJE_DE_EJEMPLO"}

Il 201 conferma la creazione del messaggio. Verificane l'evoluzione prima di supporre che sia arrivato al destinatario.

Verifica l'accesso al numero, il consenso del destinatario e le regole di invio. Se hai più numeri, consulta il campo device nella documentazione.

Arriva una nuova conversazione

Ricevere un evento

Informare il tuo sistema di un messaggio in arrivo.

Configuri l'URL del webhook e gli eventi che ti servono. Questo frammento mostra campi di un evento; non è lo schema completo.

PulpoChatWebhook · messaggio in arrivo

POST al tuo server · esempio

POST https://tu-servidor.example/webhooks/pulpo
Content-Type: application/json
X-Idempotency-Key: ID_EVENTO_DE_EJEMPLO

{
  "id": "ID_MENSAJE_DE_EJEMPLO",
  "object": "message",
  "event": "message:in:new"
}

Risposta del tuo server · esempio

HTTP/1.1 200 OK

Il tuo server elabora l'evento e decide cosa farne. Prepara la gestione dei tentativi successivi per evitare di elaborare lo stesso evento più volte.

Usa HTTPS in produzione e convalida lo schema completo. Ricevere un webhook non invia da solo una risposta WhatsApp.

Prepari un avviso proattivo

Consultare i modelli

Trovare un modello approvato per l'avviso.

Consulta i modelli dell'account e verifica nome, lingua e contenuto prima di preparare l'invio.

PulpoChatAPI REST · modelli

Query di esempio

GET https://api.pulpo.chat/v1/waba/templates?status=approved
Token: TU_CLAVE_DE_API

Frammento di risposta · esempio

{"data":[{"name":"PLANTILLA_DE_EJEMPLO",
"status":"approved","language":"es"}],
"total":1,"page":0,"size":1}

La query restituisce i modelli che puoi verificare. Per inviare, segui il formato e i requisiti della documentazione.

I modelli approvati sono necessari quando le regole di WhatsApp lo richiedono. Questa query non crea né invia un messaggio.

Dall'esempio all'integrazione.

Prova la richiesta, prepara il ricevitore dell'evento o consulta lo schema dei modelli.

Creare il messaggio dal tuo sistema

Consulta lo schema dei messaggi e prova la richiesta con un account preparato nel tester dell'API.

Apri il tester dell'API

Ricevere ciò che accade su WhatsApp

Prepara il ricevitore HTTPS, seleziona gli eventi e gestisci i tentativi successivi prima di usarlo in produzione.

Consulta la guida ai webhook

Verificare i modelli dell'account

Consulta i modelli approvati e i formati di invio con lingua e variabili.

Apri la documentazione dell'API

Preferisci preparare un percorso visivo?

Flows riunisce passaggi e connessioni che devi configurare e provare. Il server MCP permette di richiedere attività da un client autorizzato come ChatGPT o Claude.

Scopri Flows Scopri il server MCP

Una chiave. Un numero. Una prova.

Mantieni le credenziali sul server e verifica l'operazione prima di collegarla al lavoro reale.

Crea e proteggi la tua chiave
Usa una chiave autorizzata per il tuo account. Salvala sul server e verificane l'accesso prima di condividere un'integrazione.
Verifica il numero
Verifica che il numero sia operativo e che il tuo account abbia accesso e capacità per l'operazione.
Prova richieste ed eventi
Consulta lo schema, fai una richiesta di prova e convalida la risposta. Se usi webhook, prepara il ricevitore e la gestione dei tentativi successivi.

Prima di iniziare

Un account autorizzato e un numero operativo.
Credenziali protette sul server; gli esempi non includono una chiave reale.
Consenso del destinatario e modelli approvati quando richiesti per l'invio.
Un ricevitore HTTPS e gestione dei tentativi successivi se usi webhook.

Inizia gratis Vedi piani e condizioni

Prima di collegare il tuo sistema.

Un 201 significa che il messaggio è arrivato?

Il 201 conferma che il messaggio è stato creato. Consulta lo stato e gli eventi disponibili per seguirne l'evoluzione; non usarlo come prova di consegna o lettura.

Posso inserire la mia chiave nella pagina web?

Mantieni la chiave sul server. Evita di esporla nel browser, in repository pubblici o esempi condivisi.

Quando serve un modello approvato?

Quando le regole di WhatsApp lo richiedono, ad esempio per messaggi proattivi fuori dalla finestra di assistenza. Consulta i requisiti e il formato di invio nella documentazione.

Prepara l'avviso che serve al tuo sistema.

Inizia gratis

Crea l'account, verifica l'accesso e consulta la documentazione per provare l'operazione.