Documentación

Esta es la guía de uso de AtendIA: cómo activar tu token, cómo enviar tus primeras notificaciones y qué puedes hacer con la API.

Está pensada para dos públicos: negocios que quieren avisar a sus clientes por WhatsApp sin complicaciones, y desarrolladores y hobbistas que quieren alertas de sus proyectos (deploys, cron, CI) en su propio WhatsApp.

Si algo no te queda claro, escríbenos a hablemos@atendia.cl.

Guía rápida de inicio

Cuatro pasos y estás enviando notificaciones:

curl "https://app.atendia.cl/api/notificacion?msg=Deploy+exitoso&token=TU_TOKEN&phone=+56986125214"

curl -X POST https://app.atendia.cl/api/notificacion \
  -H "Content-Type: application/json" \
  -d '{"msg":"Deploy exitoso","token":"TU_TOKEN","phone":"+56986125214"}'

Comandos de WhatsApp

Todo se controla por WhatsApp, escribiéndole al número de AtendIA:

Panel (app.atendia.cl)

El panel es tu espacio de administración: envíos, token e historial, todo en un lugar. No hay email ni contraseña — el acceso es por código OTP por WhatsApp.

Cómo entrar

1. Abre app.atendia.cl/login e ingresa tu número de WhatsApp.
2. Escríbele /otp al número de AtendIA. El bot te responde el código de 6 dígitos (es gratis: el propio comando abre la conversación).
3. Pega el código en la página y listo.

Detalles: el código expira a los 10 minutos, tienes 5 intentos para escribirlo y se piden máximo 3 códigos cada 15 minutos. La sesión dura 7 días.

Qué se ve en cada sección

Seguridad

• El token plano se muestra una sola vez al activarlo; el servidor solo guarda su hash.
• La rotación (/new-token o botón en el panel) invalida el token anterior al instante.
• El panel solo muestra tu propio espacio: cada número de WhatsApp es una cuenta.

API de notificaciones

Endpoint

GET/POST https://app.atendia.cl/api/notificacion

Alias compatible: https://app.atendia.cl/api/notify (mismo comportamiento).

Parámetros

Respuestas

HTML

El campo msg acepta HTML simple (negrita, cursiva, listas, saltos de línea) y se convierte automáticamente al formato de WhatsApp. Solo se traduce texto — no se ejecuta nada.

Errores comunes

• 401: revisa que copiaste el token completo (at_ + 32 caracteres). Si lo perdiste, usa /new-token.
• 403: el plan free solo envía a tu propio número. Para terceros, se necesita el plan pago (próximamente).
• 429: agotaste tu cupo mensual de envíos facturables. Se renueva el día 1 de cada mes.

Ejemplos por caso de uso

curl -s "https://app.atendia.cl/api/notificacion?msg=Backup+completado+OK&token=TU_TOKEN&phone=+56986125214"

const res = await fetch("https://app.atendia.cl/api/notificacion", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ msg: "Deploy exitoso", token: "TU_TOKEN", phone: "+56986125214" }),
});
console.log(res.status);

import requests
r = requests.post("https://app.atendia.cl/api/notificacion", json={
    "msg": "Alerta: servicio caído",
    "token": "TU_TOKEN",
    "phone": "+56986125214",
})
print(r.status_code)

https://app.atendia.cl/api/notificacion?msg=Puerta+abierta&token=TU_TOKEN&phone=+56986125214

Planes y precios

La ventana de 24 horas (lo que cambia tu cupo)

WhatsApp permite enviar texto libre gratis mientras el destinatario tenga la conversación activa (te escribió hace menos de 24 horas). AtendIA usa esa regla a tu favor:

• Dentro de la ventana (conversación activa): el envío es gratis e ilimitado — no consume tu cupo mensual.
• Fuera de la ventana(envío "en frío"): el envío es facturable y consume tu cupo.

En la práctica: los 30 mensajes del plan free son envíos facturables; si hablas con el destinatario, puedes notificarle sin límite ni costo. Cada mensaje nuevo del destinatario reinicia la ventana a 24 horas completas.

Cómo pagar

El plan paid está próximamente (pagos vía MercadoPago en desarrollo). Mientras tanto, si te interesa, escríbenos a hablemos@atendia.cl para sumarte a la lista.

FAQ ampliada

Estado y roadmap breve

Versión actual: v0.47.0.

Lo que funciona hoy:

• Activación por WhatsApp (/start o keyword), token con rotación (/new-token).
• API de envío GET/POST con alias /api/notify, HTML, respuestas 200–500.
• Panel app.atendia.cl con login OTP por WhatsApp: dashboard, API Keys, Envíos, Configuración.
• Comandos de estado: /estado, /help.
• Ventana de 24h: envíos gratuitos e ilimitados en conversación activa.

Próximamente:

• Pagos MercadoPago para los planes paid (990 CLP/mes, 9.990 CLP/año, 19.990 CLP de por vida; 500 mensajes/mes, sin footer).
• Más plantillas y multi-idioma.
• Personalización del nombre del remitente.

Para enterarte de novedades o dejar feedback: hablemos@atendia.cl.