Respuesta automática a leads con WhatsApp API

Este escenario envía un mensaje de texto libre de WhatsApp con sendMessage dentro de la ventana de atención al cliente de 24 horas después de que el cliente escribió primero sobre un producto o servic

Probar la demo Ver ejemplo de código

Descripción del caso de uso

Ejemplo de plantilla

Hola, {{1}}! Recibimos tu solicitud sobre «{{2}}». {{3}} la está revisando y responderá pronto.

{{1}}
nombre del cliente
{{2}}
tema de la solicitud o área de producto
{{3}}
nombre del gerente de ventas asignado

WhatsApp Business API for session reply — incoming client request

Cuándo usarlo

Usa este escenario cuando un prospecto escribe primero en WhatsApp preguntando por un producto o servicio y necesitas confirmar la solicitud antes de que un gerente de ventas responda con detalles. Encaja en flujos de ventas entrantes donde el cliente ya abrió la ventana de sesión de 24 horas y dejarlo esperando sin respuesta arriesga perder el lead.

Menos leads esperando sin respuesta

El webhook entrante dispara sendMessage en cuanto llega el mensaje del cliente, así el prospecto recibe confirmación en la misma sesión antes de que un gerente abra el hilo.

Sin fricción de cold-start con plantilla

sendMessage funciona dentro de la ventana de atención al cliente de 24 horas abierta, así evitas aprobación de plantilla y el costo extra de reabrir un diálogo que el cliente ya inició.

El tema de la solicitud queda en el chat

Tres variables del cuerpo llevan el nombre del cliente, el tema de la solicitud que tu backend extrajo del CRM y el gerente asignado, así la confirmación queda buscable en WhatsApp y no es un recibo genérico.

Derivación clara a ventas

El mensaje nombra al gerente asignado y deja claro que habrá una respuesta detallada en la misma sesión, así el cliente sabe quién atiende la solicitud mientras el gerente prepara la respuesta.

Flujo de trabajo

Estado registrado
Llega un mensaje entrante del cliente vía webhook.
status: "read"
Capturar evento
Tu backend mapea el chat a un lead y extrae el tema de la solicitud.
POST /sendMessage
Construir y enviar
Un mensaje de texto en sesión confirma la solicitud y nombra al gerente.
POST /sendMessage
Entregado
El gerente continúa el diálogo con una respuesta detallada en la misma sesión.
entregado

Implementación técnica

Requisitos previos

Clave API de 1MSG · Cómo obtener la clave API
Cuenta de WhatsApp Business · Cómo conectar WABA
Ventana de sesión de 24 horas abierta · Cómo funciona la ventana de 24 horas
Opt-in del cliente · Cómo gestionar el consentimiento
Endpoint de webhook · Cómo configurar webhooks

Ejemplos de código

#!/usr/bin/env bash
set -euo pipefail

# === Configuration (replace "___" placeholders) ===
API_BASE_URL="https://api.1msg.io"        # production 1MSG API base URL
CHANNEL_ID="___"                           # channel ID from 1MSG dashboard
API_TOKEN="___"                            # channel JWT token (Bearer)



# === Test data ===
TEST_PHONE="___"                 # client phone in international format · requires open 24-hour session window
TEST_CUSTOMERNAME="___"         # {{1}} customer name
TEST_TOPIC="___"         # {{2}} topic or subject
TEST_MANAGERNAME="___"         # {{3}} manager name

PHONE_NORM="$(printf '%s' "$TEST_PHONE" | tr -cd '0-9')"

for pair in "CHANNEL_ID=$CHANNEL_ID" "API_TOKEN=$API_TOKEN" "TEST_PHONE=$TEST_PHONE" \
            "TEST_CUSTOMERNAME=$TEST_CUSTOMERNAME" \
            "TEST_TOPIC=$TEST_TOPIC" \
            "TEST_MANAGERNAME=$TEST_MANAGERNAME"; do
  val="${pair#*=}"
  if [ -z "$val" ] || [ "$val" = "___" ]; then
    echo "Missing configuration value: ${pair%%=*}" >&2
    exit 1
  fi
done

if [ -z "$PHONE_NORM" ]; then
  echo "Error: phone number has no digits after normalization" >&2
  exit 1
fi

URL="${API_BASE_URL%/}/${CHANNEL_ID}/sendMessage"

read -r -d '' PAYLOAD <<JSON || true
{
  "phone": "${PHONE_NORM}",
  "body": "Hello, Alexey! We received your request about «CRM for a sales team». Manager Anna is reviewing it and will reply shortly."
}
JSON

RESPONSE="$(curl -s -w '\n%{http_code}' -X POST "$URL" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ${API_TOKEN}" \
  -d "$PAYLOAD")"

HTTP_CODE="$(printf '%s' "$RESPONSE" | tail -n1)"
BODY="$(printf '%s' "$RESPONSE" | sed '$d')"

case "$BODY" in
  *'"sent":true'*) ok=1 ;;
  *) ok=0 ;;
esac

if [ "$HTTP_CODE" -ge 200 ] && [ "$HTTP_CODE" -lt 300 ] && [ "$ok" -eq 1 ]; then
  echo "Message sent to client."
  echo "API response: $BODY"
else
  echo "Send failed. HTTP status: $HTTP_CODE" >&2
  echo "$BODY" >&2
  exit 1
fi

Respuesta y estado de entrega

HTTP 2xx y JSON "sent": true significan que 1MSG aceptó el mensaje para envío — no que ya llegó al teléfono del cliente. Guarda el campo id (tipo wamid.…) para correlacionar los callbacks de entrega.

200 OKRespuesta

{
  "sent": true,
  "message": "Sent to [email protected]",
  "description": "Message has been sent to the provider",
  "id": "wamid.HBgLMzgwNjM5..."
}

sent
Aceptado para envío — aún no en el teléfono del cliente
id
Guárdalo; los callbacks de entrega y hookInfo se basan en él

Estados de entrega y webhooks →

Errores frecuentes

Estado	Respuesta de la API	Causa	Solución
200	Message was not sent: provide chatId, phone, bsuid, or username	Ningún destinatario que el canal pudiera resolver.	Envía un solo destinatario: phone (código de país y número, solo dígitos), chatId (por ejemplo [email protected]) o bsuid.
200	Message was not sent: empty body	Falta el campo body o está vacío.	Envía un body no vacío. Es obligatorio en mensajes de texto, botones de respuesta y listas.
401	token is required	La petición no incluye el token.	Agrega el token del canal como parámetro token en la URL: https://api.1msg.io/{channelId}/{method}?token=…