Responder disponibilidad de stock 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 pregunte si un artículo está disponible.

Probar la demo Ver ejemplo de código

Descripción del caso de uso

Ejemplo de plantilla

Hola, {{1}}! «{{2}}» está actualmente {{3}}. Responde aquí si quieres reservar, recibir alerta de reposición o ver opciones similares.

{{1}}
nombre del cliente
{{2}}
nombre del producto o servicio
{{3}}
estado de disponibilidad o fecha estimada

WhatsApp Business API for session reply — availability inquiry

Cuándo usarlo

Úsalo cuando un prospecto pregunta si un producto o servicio está en stock o se puede reservar dentro de un chat de WhatsApp abierto y la respuesta debe llegar antes de que se vaya con un competidor. Encaja en equipos de ventas que consultan inventario en vivo desde OMS o CRM, desarrolladores que conectan respuestas en sesión vía webhook, y agencias que manejan disponibilidad para catálogos de clientes.

Menos ventas perdidas por respuestas tardías

Cuando llega una pregunta de disponibilidad vía webhook, tu backend obtiene el SKU y sendMessage devuelve el nombre del producto y el estado actual como tres variables del cuerpo dentro de la ventana de sesión de 24 horas abierta, así el cliente recibe respuesta en el mismo hilo sin esperar a un vendedor.

Stock en vivo en lugar de texto desactualizado

A diferencia de una plantilla cold-start, sendMessage lleva el estado de inventario o cupo obtenido del OMS o CRM al momento del envío, así la línea de disponibilidad refleja lo que hay o cuándo llega reposición.

Siguientes pasos en el mismo hilo sin botón

El mensaje invita al cliente a responder en el chat para reservar, recibir alerta de reposición o ver opciones similares, así la compra o reserva continúa sin salir de WhatsApp.

Redacción consistente de disponibilidad

Cada respuesta usa la misma estructura de tres variables — nombre del cliente, producto o servicio, estado de disponibilidad o fecha estimada — así los vendedores no retipean respuestas ad hoc que se contradicen entre sí.

Flujo de trabajo

Estado registrado
Llega un mensaje entrante del cliente con una pregunta de disponibilidad vía webhook.
status: "read"
Tu backend obtiene el
Tu backend obtiene el SKU y el estado actual de stock o cupo.
status: "read"
Construir y enviar
Un mensaje de texto en sesión envía el nombre del producto y resumen de disponibilidad.
POST /sendMessage
Entregado
El cliente continúa el diálogo para reservar o elegir alternativas.
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_PRODUCTORSERVICENAME="___"         # {{2}} product or service name
TEST_STATUS="___"         # {{3}} status label

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_PRODUCTORSERVICENAME=$TEST_PRODUCTORSERVICENAME" \
            "TEST_STATUS=$TEST_STATUS"; 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! «Premium Plan license» is currently in stock — ready to ship today. Reply here if you want to reserve, get a restock alert, or see similar options."
}
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=…