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.

INIZIARiferimento 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/webhookAutorizzazione
: 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/whatsappmessageAutorizzazione
: 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 >>>
{
  "type": "message-event",
  "payload": {
    "id": "ee4a68a0-1203-4c85-8dc3-49d0b3226a35",
    "type": "delivered"
  }
}

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

import fetch from "node-fetch";
const auth = Buffer.from(`${APP_ID}:${APP_SECRET}`).toString("base64");

await fetch("https://api.chatarchitect.com/whatsappmessage", {
  method: "POST",
  headers: { "Authorization": `Basic ${auth}`, "Content-Type": "application/json" },
  body: JSON.stringify({
    channel: "whatsapp",
    destination: "96996999699",
    payload: { type: "text", message: "Ciao John!" }
  })
});


‍

Pitone

import requests, base64
auth = base64.b64encode(f"{APP_ID}:{APP_SECRET}".encode()).decode()
r = requests.post(
  "https://api.chatarchitect.com/whatsappmessage",
  headers={"Authorization": f"Basic {auth}", "Content-Type": "application/json"},
  json={"channel": "whatsapp", "destination": "96996999699", "payload": {"type": "text", "message": "Ciao John!"}}
)
print(r.json())


‍