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.

COMENZARReferencia 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/webhookAutorizació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/whatsappmessageAutorización
: Básica
Content-Type: application/json

{
  "channel": "whatsapp",
  "destination": "96996999699",
  "payload": {
    "type": "text",
    "message": "Hola John, ¿cómo estás?"
  }
}

 

  1. Recibir 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. Recupere o cree plantillas fácilmente mediante la API.

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

 

  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/a {{1}}! Tu código de descuento es {{2}}.",
    "example": "¡Bienvenido/a [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

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


‍