Créez rapidement des intégrations WhatsApp grâce à l'API ChatArchitect

Connectez facilement vos systèmes à WhatsApp grâce à notre API REST : envoyez et recevez des messages, suivez l’état de la livraison et gérez les modèles.

PREMIERS PAS Référence de l'API

1. Introduction

ChatArchitect propose une API simple et fiable pour intégrer la messagerie WhatsApp à vos systèmes, applications ou CRM. Vous pouvez envoyer des messages texte, multimédias et interactifs, suivre les statuts, gérer des modèles et stocker des données personnalisées, le tout via de simples requêtes HTTPS.

2. Démarrage rapide

  1. Authentifiez-vous avec vos identifiants : utilisez votre APP_ID et votre APP_SECRET via l’authentification de base.
  2. Enregistrez votre webhook
Exemple >>>
POST https://api.chatarchitect.com/webhook
 Autorisation : Basique Content-Type: application/json
 {   "channel" : "whatsapp" ,   "destination" : "96996999699" ,   "webhook" : "https://your-server.com/webhook" ,   "webhook_separate" : "false"
 }

 

  1. Envoyez votre premier message
Exemple >>>
Requête POST https://api.chatarchitect.com/whatsappmessage
 Autorisation : Basique Content-Type: application/json
 {   "channel" : "whatsapp" ,   "destination" : "96996999699" ,   "payload" : {     "type" : "text" ,     "message" : "Salut John, comment vas-tu ?"
 } }

 

  1. Recevez des mises à jour de livraison via Webhook
Exemple >>>
{   "type" : "message-event" ,   "payload" : {     "id" : "ee4a68a0-1203-4c85-8dc3-49d0b3226a35" ,     "type" : "delivered"
 } }

3. Types de messages pris en charge

Taper Description Exemple de champ
texte SMS simple message
image Envoyer les images (JPG/PNG) URL d'origine
audio Envoyer l'audio (MP3/OGG/AAC) URL
vidéo Envoyer des vidéos (MP4) URL, légende
déposer Envoyer des documents nom de fichier, légende
emplacement Envoyer les coordonnées GPS latitude, longitude
contact Envoyer les coordonnées contact
liste / réponse rapide Messages interactifs options

4. Modèles de messages (HSM)

Des modèles sont nécessaires pour les messages initiés par l'entreprise. Récupérez ou créez facilement des modèles via l'API.

  1. Récupérer les modèles disponibles
Exemple >>>
POST https://api.chatarchitect.com/getHSM
 Autorisation : Basique {   "channel" : "whatsapp" ,   "destination" : "96996999699" ,   "getHSM" : "true"
 }

 

  1. Soumettre un nouveau modèle
Exemple >>>
POST https://api.chatarchitect.com/submit_template {
 "   channel" : "whatsapp" ,   "destination" : "96996999699" ,   "submit_template" : {     "elementName" : "welcome_offer" ,     "languageCode" : "en_US" ,     "category" : "MARKETING" ,     "templateType" : "TEXT" ,     "content" : "Bienvenue {{1}} ! Votre code de réduction est {{2}}." ,     "example" : "Bienvenue [John] ! Votre code de réduction est [12345]."
 } }

5. Webhooks et événements

Type d'événement Description
message Nouveaux messages entrants
événement de message Statuts de livraison (envoyé, livré, lu, échec)
événement utilisateur Inscription/désinscription de l'utilisateur

6. Exemples d'extraits de code

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


‍