La Core API de WACRM para desarrolladores y agentes

Autenticación, alcances e idempotencia

Cada ruta v1 revisa primero los alcances de la credencial: una clave creada sin contacts:write, por ejemplo, recibe 403 insufficient_scope en POST /v1/contacts sin importar el plan del proyecto. La mayoría de los alcances son opcionales al crear la clave — solo unos pocos por defecto (como templates:read para una clave de tienda) se otorgan automáticamente, así que una clave solo tiene el acceso que realmente se le dio.

Una escritura que nunca debería ejecutarse dos veces — enviar un mensaje, proponer una acción de agente, crear una tarea desde una conversación — requiere un encabezado Idempotency-Key dado por quien llama. Reintentar la misma solicitud con la misma clave repite la primera respuesta tal cual, en vez de enviar o crear algo una segunda vez, que es lo que permite reintentar con seguridad tras un corte de red. Para POST /v1/messages esa ventana de repetición es de 24 horas; para proponer una acción de agente o crear una tarea, la clave es única por proyecto y no caduca.

Referencia de endpoints

Generada en cada compilación desde el mismo archivo openapi-v1.yaml contra el que se prueba por contrato la propia Core API — cada ruta, método y alcance requerido abajo viene directamente de ese archivo, agrupado por su etiqueta de OpenAPI.

Formato de error

Cada respuesta que no es 2xx es un objeto JSON con el mismo formato:

{ "error": { "code": "insufficient_scope", "message": "razón legible" } }