Crea integraciones de WhatsApp rápidamente con la API de ChatArchitect.

Conecta fácilmente tus sistemas a WhatsApp utilizando nuestra API REST: envía y recibe mensajes, realiza un seguimiento del estado de entrega y gestiona plantillas.

Referencia de la API para empezar

1. Introducción

ChatArchitect proporciona una API sencilla y fiable para integrar la mensajería de WhatsApp en tus sistemas, aplicaciones o CRM. Puedes enviar mensajes de texto, multimedia e interactivos, realizar un seguimiento de los estados, gestionar plantillas y almacenar datos personalizados, todo ello mediante simples solicitudes HTTPS.

2. Inicio rápido

  1. Autentícate con tus credenciales: Usa tu APP_ID y APP_SECRET mediante autenticación básica.
  2. Registra tu webhook
Ejemplo >>>
POST https://api.chatarchitect.com/webhook Autorización
 : Básica Content-Type: application/json
 {   "channel" : "whatsapp" ,   "destination" : "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
 {   "channel" : "whatsapp" ,   "destination" : "96996999699" ,   "payload" : {     "type" : "text" ,     "message" : "Hola John, ¿cómo estás?"
 } }

 

  1. Reciba actualizaciones de entrega a través de Webhook
Ejemplo >>>
{   "type" : "message-event" ,   "payload" : {     "id" : "ee4a68a0-1203-4c85-8dc3-49d0b3226a35" ,     "type" : "delivered"
 } }

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. Obtenga o cree plantillas fácilmente a través de la API.

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

 

  1. Enviar una nueva plantilla
Ejemplo >>>
POST https://api.chatarchitect.com/submit_template {
 "   channel" : "whatsapp" ,   "destination" : "96996999699" ,   "submit_template" : {     "elementName" : "welcome_offer" ,     "languageCode" : "en_US" ,     "category" : "MARKETING" ,     "templateType" : "TEXT" ,     "content" : "¡Bienvenido {{1}}! Tu código de descuento es {{2}}." ,     "example" : "¡Bienvenido [John]! Tu código de descuento es [12345]."
 } }

5. Webhooks y eventos

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

6. Ejemplos de fragmentos de código

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


‍

Pitón

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())


‍