CRMamoCRM

Solución de problemas de la CLI de amoCRM

Arregla un token rechazado, una suscripción terminada, una cuenta bloqueada o una escritura rechazada.

Haz que amo vuelva a funcionar a partir del mensaje que muestra. Un token que caducó, un perfil que falta en el comando y una cuenta de amoCRM que dejó de responder tienen cada uno su propio mensaje y su propia solución.

Buscas tu síntoma en la tabla, haces la comprobación que indica y vuelves a ejecutar el comando. Si sigue fallando, tienes el código de error y el nombre del perfil listos para una petición de ayuda. Tu agente puede hacer lo mismo: cada error nombra su motivo, como session.expired, así que sabe qué pasó.

amo doctor muestra qué está configurado sin la red ni el llavero. amo work session status --check pregunta a la cuenta con qué usuario actúa el inicio de sesión.

En esta página:

  1. Primeras comprobaciones
  2. Síntomas y qué hacer
  3. Pedir ayuda

Primeras comprobaciones

amo doctor                         # the version, the settings, the profiles, without the network
amo work session status --check    # the account and the user the sign-in acts as
amo work store status              # how far each kind's sync is, and when it last ran

Síntomas y qué hacer

SíntomaQué hacer
No sabes qué está configuradoEjecuta amo doctor. No lee el llavero ni usa la red.
No se encuentra amoAbre una terminal nueva y comprueba que la carpeta global de npm está en PATH.
"name a profile"Pon el perfil primero, como en amo work config show, o define AMO_PROFILE.
El archivo de ajustes no se leedoctor lista cada problema del archivo en config.issues. Ejecuta el config unset que da cada uno, o corrige el archivo a mano.
doctor muestra files.problemsOtros usuarios del ordenador pueden leer config.json o entrar en su carpeta. Ejecuta cada chmod que doctor imprime después de "to make it private:". doctor nunca cambia los permisos de un archivo por sí mismo.
"not signed in" (session.missing)Ejecuta amo work setup, o amo work session start --host con la dirección de la cuenta, como muestra instala y conecta.
"amoCRM refused the token" (session.expired)El token de larga duración caducó o se retiró, o --host nombra otra cuenta. Crea un token nuevo y vuelve a ejecutar amo work session start con la dirección de la cuenta, como muestra instala y conecta.
El inicio de sesión en el navegador dejó de funcionaramo no se usó durante más de 3 meses y el refresh token de amoCRM caducó. Vuelve a iniciar sesión, como muestra inicia sesión con la integración.
"another profile here already signs in to this account as this user" (session.duplicate)Usa ese perfil, o quítalo con amo <profile> account remove --keep-data y vuelve a iniciar sesión.
La sincronización copia negociaciones de otra persona, o no todas las tuyasUna sincronización copia las negociaciones del usuario que inició sesión, o de los usuarios que eligió un administrador. Busca los ids con users list y ponlos como muestra qué negociaciones copia sync.
Un contacto o una empresa no está en la copiaLa copia solo guarda los clientes de tus negociaciones. Lee cualquier otro en directo con people list u organizations list.
"the account has no API filter add-on" (amo.filters-off)Una lista en directo de contactos o empresas solo filtra por responsable o por fecha con el complemento de pago de filtros de la API de amoCRM. Busca por palabras en su lugar, como amo work people list "Anna".
No hay más teléfonos ni correos hoy (crm.foreign-contacts-spent)Un usuario que no es administrador ve los de como máximo 100 contactos y empresas más al día. La cuenta vuelve a empezar al día siguiente (UTC).
"the token's user may not do this in amoCRM" (amo.access-denied)Lo rechazan los propios permisos de amoCRM. Un administrador da ese permiso al usuario en amoCRM, o un administrador inicia sesión en el perfil en su lugar.
"only an amoCRM administrator …" (employee.delete, employee.clear, employee.unbind)Borrar, dejar un campo vacío y desvincular registros necesitan el inicio de sesión de un administrador. Mira los permisos.
rate_limited (salida 8)amo se mantiene en 5 peticiones por segundo y espera por sí mismo cuando el rechazo es corto. Espera un minuto y ejecuta el comando una vez más.
outcome_unknown (salida 14) en una escrituraPuede que amoCRM haya hecho el cambio. Ejecuta sync, mira el registro con show y vuelve a escribirlo solo si el cambio no está.
"the amoCRM subscription has ended" (amo.subscription-ended)Renueva la suscripción en amoCRM. Las escrituras se detienen enseguida, y las lecturas 30 días después.
"amoCRM blocks every request" (amo.blocked)Detén todos los comandos de amo en la cuenta y revísala en amoCRM: demasiadas peticiones, o una dirección que no está en su lista de permitidas.
Se rechaza una escrituraLa detienen los permisos del perfil o AMO_READ_ONLY. Mira los permisos.

Pedir ayuda

Guarda el código de error y el nombre del perfil. amo doctor reports create escribe un informe del problema en un archivo y dice adónde enviarlo. Pregunta en Discord, o abre una incidencia en el repositorio de amo-cli.

Nunca pegues un token, una contraseña ni contenido privado en una petición de ayuda.