Saltar al contenido
AdSmartBotAyuda
EntrarPruébalo gratis

Tu primera llamada

En cinco minutos: creas una clave de acceso, compruebas que funciona y le envías una plantilla de WhatsApp a un cliente.

  • 4 pasos
  • 5 minutos
  • Dueño o administrador

  1. Crea una clave de acceso

    Entra a Configuración → Integraciones → API y avisos y pulsa Crear clave. Ponle el nombre del sistema que la va a usar («Tienda») y elige para qué es: para este ejemplo, «Tienda: confirmar pedidos».

    Copia la clave (empieza por ak_live_) y guárdala en tu sistema como una variable de entorno, por ejemplo CLAVE_API. Se ve una sola vez. Nunca la pongas en una dirección web ni en el código de una página.

    Abrir API y avisos

  2. Comprueba que funciona

    GET /me devuelve la clave con que llamas, sus permisos y la cuenta. Es lo que Zapier y Make llaman «probar la conexión».

    curl https://panel.adsmartbot.com/api/v1/me \
  -H "Authorization: Bearer $CLAVE_API"

    Lo que vas a ver: un JSON con "object": "api_key_info", el nombre de tu clave y el de tu cuenta. Si ves invalid_api_key, revisa que copiaste la clave completa.

  3. Mira tus plantillas aprobadas

    A un cliente que no te ha escrito en las últimas 24 horas, WhatsApp solo deja enviarle una plantilla aprobada. Esta lista trae el nombre exacto, el idioma y cuántas variables lleva cada una.

    curl -X GET "https://panel.adsmartbot.com/api/v1/whatsapp/templates" \
  -H "Authorization: Bearer $CLAVE_API"

  4. Envía la plantilla

    Con to.phone y create_contact: true, si el cliente no existe se crea en el mismo paso. Las variables van en orden en template.body, y {{nombre_pila}} se rellena con los datos del contacto.

    Envía siempre una Idempotency-Key (por ejemplo, el número de pedido y lo que haces): si tu sistema reintenta, el cliente no recibe el mensaje dos veces.

    curl -X POST "https://panel.adsmartbot.com/api/v1/messages" \
  -H "Authorization: Bearer $CLAVE_API" \
  -H "Content-Type: application/json" \
  -d '{"to":{"phone":"+57 300 123 4567","name":"Ana","whatsapp_opt_in":{"source":"checkout","evidence":"Marcó «Quiero recibir el estado de mi pedido por WhatsApp» en el pago","captured_at":"2026-09-26T14:02:00-05:00"}},"create_contact":true,"type":"template","template":{"name":"pedido_enviado","language":"es","body":["{{nombre_pila}}","A-1043","TCC 88213"]},"pause_ai":false,"idempotency_key":"pedido-A-1043-enviado"}'

    Si el cliente nunca te ha escrito, WhatsApp exige la prueba de que aceptó recibir tus mensajes: envíala en to.whatsapp_opt_in con su fuente, lo que aceptó y cuándo.

Y ahora, que tu sistema se entere

Para que tu sistema se entere de cada contacto nuevo, cada etiqueta, cada mensaje o cada cita, suscribe una dirección de tu sistema. También se hace desde el panel, en Avisos a otros sistemas. Ver cómo funcionan los avisos.

Suscribirse por la API pide otra clave: la de «Tienda» no trae Gestionar los avisos. Crea una con el paquete «Zapier, Make o n8n» (o «A la medida» con Gestionar los avisos). Cada aviso pide además poder leer lo que cuenta: los de mensajes y conversaciones, Leer conversaciones, que ningún paquete marca solo porque son las charlas con tus clientes.

curl -X POST "https://panel.adsmartbot.com/api/v1/webhooks" \
  -H "Authorization: Bearer $CLAVE_API" \
  -H "Idempotency-Key: createWebhook-A-1043" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://hooks.zapier.com/hooks/catch/123456/abcdef/","events":["contact.created","contact.tag_added"],"name":"Zapier: contactos nuevos","filters":{"tag":"VIP"}}'