Erstellen Sie WhatsApp-Integrationen schnell mit der ChatArchitect API.

Verbinden Sie Ihre Systeme ganz einfach mit WhatsApp über unsere REST-API – senden und empfangen Sie Nachrichten, verfolgen Sie Zustellstatus und verwalten Sie Vorlagen.

Erste Schritte API-Referenz

1. Einleitung

ChatArchitect bietet eine einfache und zuverlässige API zur Integration von WhatsApp Messaging in Ihre Systeme, Apps oder CRMs. Sie können Text-, Medien- und interaktive Nachrichten senden, Statusmeldungen verfolgen, Vorlagen verwalten und benutzerdefinierte Daten speichern – alles mit einfachen HTTPS-Anfragen.

2. Schnellstart

  1. Authentifizieren Sie sich mit Ihren Zugangsdaten: Verwenden Sie Ihre APP_ID und Ihr APP_SECRET über die Basisauthentifizierung.
  2. Registrieren Sie Ihren Webhook
Beispiel >>>
POST https://api.chatarchitect.com/webhook
 Autorisierung: Basic Content-Type: application/json
 {   "channel" : "whatsapp" ,   "destination" : "96996999699" ,   "webhook" : "https://your-server.com/webhook" ,   "webhook_separate" : "false"
 }

 

  1. Sende deine erste Nachricht
Beispiel >>>
POST https://api.chatarchitect.com/whatsappmessage
 Autorisierung: Basic Content-Type: application/json
 {   "channel" : "whatsapp" ,   "destination" : "96996999699" ,   "payload" : {     "type" : "text" ,     "message" : "Hi John, how are you?"
 } }

 

  1. Erhalten Sie Lieferbenachrichtigungen per Webhook
Beispiel >>>
{   "type" : "message-event" ,   "payload" : {     "id" : "ee4a68a0-1203-4c85-8dc3-49d0b3226a35" ,     "type" : "delivered"
 } }

3. Unterstützte Nachrichtentypen

Typ Beschreibung Beispielfeld
Text Einfache Textnachricht Nachricht
Bild Senden Sie Bilder (JPG/PNG) originalURL
Audio- Audio senden (MP3/OGG/AAC) URL
Video Videos senden (MP4) URL, Bildunterschrift
Datei Dokumente senden Dateiname, Bildunterschrift
Standort GPS-Koordinaten senden Breitengrad, Längengrad
Kontakt Kontaktinformationen senden Kontakt
Liste / Schnellantwort Interaktive Nachrichten Optionen

4. Nachrichtenvorlagen (HSM)

Für geschäftlich initiierte Nachrichten werden Vorlagen benötigt. Vorlagen können einfach über die API abgerufen oder erstellt werden.

  1. Verfügbare Vorlagen abrufen
Beispiel >>>
POST https://api.chatarchitect.com/getHSM
 Autorisierung: Basic {   "channel" : "whatsapp" ,   "destination" : "96996999699" ,   "getHSM" : "true"
 }

 

  1. Neue Vorlage einreichen
Beispiel >>>
POST https://api.chatarchitect.com/submit_template {
 "   channel" : "whatsapp" ,   "destination" : "96996999699" ,   "submit_template" : {     "elementName" : "welcome_offer" ,     "languageCode" : "en_US" ,     "category" : "MARKETING" ,     "templateType" : "TEXT" ,     "content" : "Willkommen {{1}}! Ihr Rabattcode lautet {{2}}." ,     "example" : "Willkommen [John]! Ihr Rabattcode lautet [12345]."
 } }

5. Webhooks und Ereignisse

Ereignistyp Beschreibung
Nachricht Neue eingehende Nachrichten
Nachrichtenereignis Zustellungsstatus (gesendet, zugestellt, gelesen, fehlgeschlagen)
Benutzerereignis Nutzer-Opt-in / Opt-out

6. Beispielcode-Ausschnitte

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 : "Hi John!" } } ) });


‍

Python

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" : "Hi John!" }} ) print(r.json())


‍