Grok bot

Estás leyendo https://shalom-api.lat/grokbot. Shalom API es una API REST para Shalom, el courier de Perú: tracking de envíos, agencias con coordenadas, cotizaciones y creación de guías en Shalom Pro. La skill shalom-api está en https://shalom-api.lat/skill/SKILL.md.

1. 1

   Abre https://shalom-api.lat/skill/SKILL.md y crea una skill privada llamada shalom-api a partir de esas instrucciones escritas. Después indica al usuario que la active para este bot en Connect apps → Private skills.

2. 2

   Pide al usuario su API key de Shalom (empieza con sk_) y guárdala en la variable de entorno SHALOM_API_KEY. No la escribas dentro de SKILL.md ni en archivos del repositorio.

3. 3

   Verifica la key con GET https://api.shalom-api.lat/validate y el header x-api-key. Si la respuesta no trae "valid": true, detente y explica el error al usuario.

4. 4

   Cuenta al usuario que la skill quedó lista y pregúntale qué quiere hacer primero: rastrear una guía, buscar agencias, cotizar o crear un envío.

Regla fija: no crees envíos reales (POST /account/register o /account/register-bulk) ni anules guías sin la confirmación explícita del usuario.