Crea rapidamente integrazioni WhatsApp con l'API ChatArchitect

Collega facilmente i tuoi sistemi a WhatsApp utilizzando la nostra API REST: invia e ricevi messaggi, monitora lo stato delle consegne e gestisci i modelli.

INIZIA Riferimento API

1. Introduzione

ChatArchitect fornisce un'API semplice e affidabile per integrare la messaggistica WhatsApp nei tuoi sistemi, app o CRM. Puoi inviare messaggi di testo, multimediali e interattivi, monitorare gli stati, gestire modelli e archiviare dati personalizzati, il tutto con semplici richieste HTTPS.

2. Avvio rapido

  1. Autenticazione con le tue credenziali: usa APP_ID e APP_SECRET tramite Autenticazione di base.
  2. Registra il tuo webhook
Esempio >>>
POST https://api.chatarchitect.com/webhook Autorizzazione
 : Base Content-Type: application/json
 {   "channel" : "whatsapp" ,   "destination" : "96996999699" ,   "webhook" : "https://your-server.com/webhook" ,   "webhook_separate" : "false"
 }

 

  1. Invia il tuo primo messaggio
Esempio >>>
POST https://api.chatarchitect.com/whatsappmessage
 Autorizzazione: Base Content-Type: application/json
 {   "channel" : "whatsapp" ,   "destination" : "96996999699" ,   "payload" : {     "type" : "text" ,     "message" : "Ciao John, come stai?"
 } }

 

  1. Ricevi aggiornamenti sulla consegna tramite Webhook
Esempio >>>
{   "tipo" : "messaggio-evento" ,   "carico utile" : {     "id" : "ee4a68a0-1203-4c85-8dc3-49d0b3226a35" ,     "tipo" : "consegnato"
 } }

3. Tipi di messaggi supportati

Tipo Descrizione Campo di esempio
testo Semplice messaggio di testo messaggio
immagine Invia immagini (JPG/PNG) URL originale
audio Invia audio (MP3/OGG/AAC) URL
video Invia video (MP4) url, didascalia
file Invia documenti nome file, didascalia
posizione Invia le coordinate GPS latitudine, longitudine
contatto Invia informazioni di contatto contatto
elenco / risposta rapida Messaggi interattivi opzioni

4. Modelli di messaggio (HSM)

I modelli sono necessari per i messaggi aziendali. Recupera o crea facilmente modelli tramite API.

  1. Recupera i modelli disponibili
Esempio >>>
POST https://api.chatarchitect.com/getHSM Autorizzazione
 : Base {   "canale" : "whatsapp" ,   "destinazione" : "96996999699" ,   "getHSM" : "vero"
 }

 

  1. Invia un nuovo modello
Esempio >>>
POST https://api.chatarchitect.com/submit_template {
 "   channel" : "whatsapp" ,   "destination" : "96996999699" ,   "submit_template" : {     "elementName" : "welcome_offer" ,     "languageCode" : "en_US" ,     "category" : "MARKETING" ,     "templateType" : "TEXT" ,     "content" : "Benvenuto {{1}}! Il tuo codice sconto è {{2}}." ,     "example" : "Benvenuto [John]! Il tuo codice sconto è [12345]."
 } }

5. Webhook ed eventi

Tipo di evento Descrizione
messaggio Nuovi messaggi in arrivo
messaggio-evento Stati di consegna (inviato, consegnato, letto, fallito)
evento utente Opt-in / opt-out dell'utente

6. Esempi di frammenti di codice

Node.js

importa fetch da  "node-fetch" ; const auth = Buffer.from( ` ${APP_ID} : ${APP_SECRET} ` ).toString( "base64" );
 attendi fetch( "https://api.chatarchitect.com/whatsappmessage" , {   metodo : "POST" ,   intestazioni : { "Autorizzazione" : `Basic ${auth} ` , "Content-Type" : "application/json" },   corpo : JSON .stringify({     canale : "whatsapp" ,     destinazione : "96996999699" ,     carico utile : { tipo : "testo" , messaggio : "Ciao John!" } } ) });


‍

Pitone

richieste di importazione  autenticazione base64 = base64.b64encode(f "{APP_ID}:{APP_SECRET}" .encode()).decode() r = requests.post(   "https://api.chatarchitect.com/whatsappmessage" , headers={ "Autorizzazione" : f "Autenticazione di base {auth}" , "Content-Type" : "application/json" }, json={ "canale" : "whatsapp" , "destinazione" : "96996999699" , "carico utile" : { "tipo" : "testo" , "messaggio" : "Ciao John!" }} ) print(r.json())


‍