---
title: "Registra el celular y genera el código de activación"
method: PUT
path: "/alertas/whatsapp"
tags: ["alertas"]
---

# Registra el celular y genera el código de activación

`PUT /alertas/whatsapp`

## Request

- Base URL: `https://contadeo.com/api`
- URL: `https://contadeo.com/api/alertas/whatsapp`
- Auth: HTTP bearer

Guarda la evidencia del consentimiento (fecha, IP y versión) y deja la suscripción pendiente. Se activa cuando la persona envía `ACTIVAR <código>` por WhatsApp desde ese mismo número, usando `enlace`. El código caduca a los 30 minutos. Máximo 5 llamadas cada 10 minutos. 403 con API key.

## Request body

- object
  - `telefono` string, required: Celular de Ecuador (0991234567) o de otro país con + y código de país
  - `aceptaConsentimiento` true, required: Aceptación del texto `textoConsentimiento`

## Response `200`

Código y enlace de activación

- AlertasWhatsappInicio
  - `disponible` boolean, required
  - `estado` 'sin_registro' | 'pendiente' | 'activa' | 'baja', required
  - `telefono` string, nullable, required: Enmascarado, p. ej. 593******567
  - `textoConsentimiento` string, required
  - `versionConsentimiento` string, required
  - `codigo` string, required: 6 caracteres
  - `enlace` string, uri, required: https://wa.me/... con ACTIVAR <código> listo para enviar
  - `expiraAt` string, date-time, required

## Other responses

- `400`: Celular no válido o consentimiento sin aceptar
- `403`: Rol insuficiente o acceso denegado
- `404`: Los avisos por WhatsApp no están disponibles en este servidor

---

[API](https://skmtc.dev/contadeo/apis/api-de-contadeo.md) · [All operations](https://skmtc.dev/contadeo/apis/api-de-contadeo/llms.txt) · [OpenAPI document](https://skmtc.dev/contadeo/apis/api-de-contadeo/revisions/461bbb9a74ce?raw)