Cree integraciones de WhatsApp rápidamente con la API de ChatArchitect

Conecte fácilmente sus sistemas a WhatsApp usando nuestra API REST: envíe y reciba mensajes, realice un seguimiento de los estados de entrega y administre plantillas.

COMENZAR Referencia API

1. Introducción

ChatArchitect ofrece una API sencilla y fiable para integrar la mensajería de WhatsApp en tus sistemas, apps o CRM. Puedes enviar mensajes de texto, multimedia e interactivos, monitorizar estados, gestionar plantillas y almacenar datos personalizados, todo con sencillas solicitudes HTTPS.

2. Inicio rápido

  1. Autentíquese con sus credenciales: utilice su APP_ID y APP_SECRET a través de la autenticación básica.
  2. Registra tu webhook
Ejemplo >>>
POST https://api.chatarchitect.com/webhook Autorización
 : Básica Tipo de contenido: aplicación/json
 {   "canal" : "whatsapp" ,   "destino" : "96996999699" ,   "webhook" : "https://your-server.com/webhook" ,   "webhook_separate" : "false"
 }

 

  1. Envía tu primer mensaje
Ejemplo >>>
POST https://api.chatarchitect.com/whatsappmessage Autorización
 : Básica Content-Type: application/json
 {   "canal" : "whatsapp" ,   "destino" : "96996999699" ,   "carga útil" : {     "tipo" : "texto" ,     "mensaje" : "Hola John, ¿cómo estás?"
 } }

 

  1. Recibir actualizaciones de entrega a través de Webhook
Ejemplo >>>
{   "tipo" : "evento-mensaje" ,   "carga útil" : {     "id" : "ee4a68a0-1203-4c85-8dc3-49d0b3226a35" ,     "tipo" : "entregado"
 } }

3. Tipos de mensajes admitidos

Tipo Descripción Campo de ejemplo
texto Mensaje de texto simple mensaje
imagen Enviar imágenes (JPG/PNG) URL original
audio Enviar audio (MP3/OGG/AAC) URL
video Enviar vídeos (MP4) URL, título
archivo Enviar documentos nombre de archivo, título
ubicación Enviar coordenadas GPS latitud, longitud
contacto Enviar información de contacto contacto
lista / respuesta rápida Mensajes interactivos opciones

4. Plantillas de mensajes (HSM)

Se requieren plantillas para los mensajes iniciados por la empresa. Recupere o cree plantillas fácilmente mediante la API.

  1. Recuperar plantillas disponibles
Ejemplo >>>
POST https://api.chatarchitect.com/getHSM Autorización
 : Básica {   "canal" : "whatsapp" ,   "destino" : "96996999699" ,   "getHSM" : "verdadero"
 }

 

  1. Enviar una nueva plantilla
Ejemplo >>>
PUBLICACIÓN https: //api.chatarchitect.com/submit_template
 {   "canal" : "whatsapp" ,   "destino" : "96996999699" ,   "submit_template" : {     "nombreDeElemento" : "ofertaDeBienvenida" ,     "códigoDeIdioma" : "en_US" ,     "categoría" : "MARKETING" ,     "tipoDeTemplate" : "TEXTO" ,     "contenido" : "¡Bienvenido {{1}}! Tu código de descuento es {{2}}." ,     "ejemplo" : "¡Bienvenido [John]! Tu código de descuento es [12345]."
 } }

5. Webhooks y eventos

Tipo de evento Descripción
mensaje Nuevos mensajes entrantes
mensaje-evento Estados de entrega (enviado, entregado, leído, fallido)
evento de usuario Opción de inclusión/exclusión del usuario

6. Fragmentos de código de ejemplo

Node.js

importar fetch desde  "node-fetch" ; const auth = Buffer.from( ` ${APP_ID} : ${APP_SECRET} ` ).toString( "base64" );
 await fetch( "https://api.chatarchitect.com/whatsappmessage" , {   método : "POST" ,   encabezados : { "Autorización" : `Basic ${auth} ` , "Tipo de contenido" : "application/json" },   cuerpo : JSON .stringify({     canal : "whatsapp" ,     destino : "96996999699" ,     carga útil : { tipo : "texto" , mensaje : "¡Hola John!" } }) });


‍

Pitón

 de importación , autenticación base64 = base64.b64encode(f "{APP_ID}:{APP_SECRET}" .encode()).decode() r = solicitudes.post(   "https://api.chatarchitect.com/whatsappmessage" , encabezados = { "Autorización" : f "{Aut.} básica" , "Tipo de contenido" : "application/json" }, json = { "canal" : "whatsapp" , "destino" : "96996999699" , "carga útil" : { "tipo" : "texto" , "mensaje" : "¡Hola John!" }} ) print(r.json())


‍