Saltar al contenido principal

Solución de problemas comunes

Solución de problemas comunes

Respuesta rápida: la mayoría de los problemas tienen una solución sencilla. Presence Rate de 0% = negocio nuevo o local (es normal, no es un error). Authority Score nulo = el Presence Rate es 0 (primero mejora la presencia). Overall Score de Site Audit < 70 = hay problemas de gravedad alta (corrige esos primero, no los 62). Recomendaciones de Strategy en conflicto = decisión dividida (elige según tu tolerancia al riesgo). Error 404 en la API de Intelligence Token = el formato del token es incorrecto (revisa si tiene espacios). Entrega con más de 2 horas de demora = escribe a hi@surmado.com. Tenemos sistemas de reembolso automático si algo sale mal.

Tiempo de lectura: 15 minutos

En esta guía:

  • Un Presence Rate de 0% es normal en negocios nuevos o locales: necesitas agregar marcado schema (el mayor retorno), crear 1 o 2 páginas de experiencia (de más de 2,000 palabras cada una), esperar de 4 a 8 semanas a que la IA se reentrene y volver a ejecutar AI Visibility, esperando una mejora de 10-20%. No es un error ni un sistema roto
  • Corrige primero los problemas de gravedad alta en los informes de Site Audit: concéntrate en las 5-15 banderas rojas de gravedad alta (sin HTTPS, LCP lento de más de 4s, texto alternativo faltante, schema faltante) que dañan la experiencia del usuario, e ignora las 20-40 recomendaciones “deseables” de gravedad baja para no abrumarte y subir el Overall Score entre 15 y 25 puntos
  • Los errores 404 en la API de Intelligence Token vienen de errores de formato, como espacios en el token (al copiar y pegar se agregan espacios al inicio o al final), un patrón incorrecto (SIG-YYYY-MM-XXXXX, no SIG-20251110-XXXXX) o probar antes de ejecutar realmente el informe. Se corrige validando primero en el navegador
  • Un Ghost Influence alto (50% o más) significa que se conocen tus características pero no se te atribuyen: debes decir explícitamente “[Tu empresa] es [característica única]” en la página de inicio y en Acerca de (no “Nuestro equipo está formado por veteranos”, sino “Veterans Moving America es 100% propiedad de veteranos y operada por ellos”), lo que reduce el Ghost Influence entre 10% y 20% en 4-8 semanas
  • Las recomendaciones contradictorias de Strategy indican decisiones realmente ambiguas: necesitas más datos (ejecuta AI Visibility o Site Audit para tener contexto cuantitativo), afinar la pregunta (agrega restricciones, metas y plazos) o aceptar la ambigüedad y elegir según tu tolerancia al riesgo (CFO/COO si evitas el riesgo, Game Theorist/Wildcard si lo buscas)

¿Tienes un problema? Busca tu síntoma abajo para encontrar una solución rápida.


Problemas de AI Visibility

Problema 1: Mi Presence Rate es 0%

Síntoma: el informe de AI Visibility muestra Presence Rate: 0.0% y Authority Score: null

Diagnóstico: las plataformas de IA todavía no tienen suficientes datos sobre tu negocio

Causas comunes:

  1. Negocio muy nuevo (menos de 6 meses, sin presencia web)
  2. Negocio muy local (una sola ubicación, área de servicio hiperlocal)
  3. B2B de nicho (industria especializada, pocas menciones en línea)
  4. Falta de marcado schema (la IA no puede encontrar los datos de tu negocio)
  5. Sin contenido (el sitio existe, pero con muy poco texto para que la IA lo indexe)

Solución:

  1. Agrega marcado schema (Qué es el marcado schema): es lo que más rinde cuando el Presence Rate es 0%
  2. Crea contenido (1 o 2 páginas de experiencia, de más de 2,000 palabras cada una)
  3. Espera de 4 a 8 semanas (los modelos de IA se reentrenan periódicamente, no en tiempo real)
  4. Ejecuta AI Visibility otra vez (mide si subió el Presence Rate)

Plazo esperado: de 6 a 12 semanas para pasar de 0% a 10-20% (si agregas schema y contenido)

¿Está roto? No. El 0% es el punto de partida de los negocios nuevos o locales, no un error.


Problema 2: Mi Authority Score es null

Síntoma: el informe de AI Visibility muestra Authority Score: null (en lugar de un puntaje de 0 a 100)

Diagnóstico: no puede haber calidad de posicionamiento si nunca te mencionan (Presence Rate = 0%)

Solución: primero mejora el Presence Rate (consulta el Problema 1 arriba). El Authority Score aparecerá cuando empieces a recibir menciones orgánicas.

¿Por qué null y no 0? Porque el Authority Score mide “con cuánta fuerza te recomienda la IA cuando te menciona”. Si nunca te mencionan (Presence Rate 0%), no hay posicionamiento que medir.


Problema 3: Mi Presence Rate es más bajo de lo que esperaba

Síntoma: AI Visibility muestra un Presence Rate de 18%, pero esperabas más de 40%

Causas comunes:

  1. Expectativas poco realistas (18% es en realidad normal para una pyme, no es malo)
  2. Desajuste de personas (las personas que enviaste no coinciden con cómo le preguntan realmente a la IA)
  3. Falta de marcado schema (la IA no puede encontrar tu negocio)
  4. Contenido genérico (tu sitio no te diferencia de la competencia)
  5. Competidores fuertes (los 3 principales dominan las respuestas de la IA)

Solución:

  1. Calibra tus expectativas: revisa el ranking competitivo (¿estás en el puesto 5 de 40? Eso es progreso, no fracaso)
  2. Revisa a los competidores (páginas 3-5 del informe de AI Visibility): si el competidor principal tiene 54%, tu 18% tiene margen para crecer
  3. Corrige el marcado schema (si falta o está incompleto)
  4. Crea contenido de experiencia (guías prácticas de más de 2,000 palabras, casos de estudio)
  5. Ejecuta AI Visibility otra vez en 4-8 semanas (mide la mejora, no la perfección)

Mejora realista: +10-20% por trimestre (con correcciones de schema y contenido)


Problema 4: Mi Ghost Influence es muy alto (50% o más)

Síntoma: AI Visibility muestra un Ghost Influence de 68% (la IA habla de tus características pero le da el crédito a la competencia)

Diagnóstico: tus características son conocidas, pero no se atribuyen a tu marca

Causas comunes:

  1. Descripciones implícitas de las características (“Nuestro equipo incluye veteranos” en lugar de “Somos 100% propiedad de veteranos”)
  2. Características enterradas en el contenido (mencionadas en el párrafo 5 de Acerca de, no en el encabezado principal de la página de inicio)
  3. Marca genérica (sin una conexión clara entre la característica y el nombre de la empresa)

Solución:

  1. Actualiza la página de inicio (declaración explícita: “[Tu empresa] es [característica única]”)
  2. Actualiza la página Acerca de (declara los diferenciadores de forma explícita en el primer párrafo)
  3. Actualiza las páginas de servicio (conecta el servicio con el nombre de la marca en la misma oración)
  4. Patrón: usa el nombre de la empresa y la característica juntos (no separados por varias oraciones)

Ejemplo de corrección:

  • Antes: “Nuestro equipo está formado por veteranos militares con experiencia que aportan disciplina y confiabilidad.”
  • Después: “Veterans Moving America es 100% propiedad de veteranos y operada por ellos. Cada miembro del equipo es un veterano militar.”

Plazo esperado: de 4 a 8 semanas para reducir el Ghost Influence entre 10% y 20%


Problema 5: AI Visibility probó personas equivocadas

Síntoma: AI Visibility probó personas que no coinciden con tu negocio

Diagnóstico: puede que las personas que enviaste se hayan malinterpretado o fueran demasiado vagas

Solución:

  1. Revisa las personas que enviaste (en el formulario de pedido original)
  2. Comprueba si son lo bastante específicas:
  • Demasiado vaga: “reparación de aire acondicionado” (podría ser cualquiera, en cualquier lugar)
  • Buena: “Reparación de emergencia de aire acondicionado en Phoenix, servicio el mismo día, fines de semana”
  1. Ejecuta AI Visibility otra vez con mejores personas (si las originales no eran las correctas)

Cómo escribir buenas personas:

  • Incluye: [Problema] + [Servicio] + [Ubicación] + [Criterios de compra]
  • Ejemplo: “Empresas de mudanzas área DFW equipos confiables y disciplinados propiedad de veteranos”

Más información: Qué son las pruebas basadas en personas


Problemas de Site Audit

Problema 6: Mi Overall Score es muy bajo (< 50)

Síntoma: Site Audit muestra un Overall Score de 42/100

Diagnóstico: varios problemas de gravedad alta dañan la experiencia del usuario

Causas comunes:

  1. Sin HTTPS (el sitio usa http:// en lugar de https://)
  2. Rendimiento lento (LCP de más de 4.0s, imágenes enormes sin comprimir)
  3. Falta de accesibilidad (sin texto alternativo en las imágenes, formularios sin etiquetas)
  4. Falta de marcado schema (la IA y Google no pueden entender el negocio)
  5. Sitio antiguo (construido hace más de 5 años, sin actualizar)

Solución (prioriza solo los de gravedad alta):

  1. Activa HTTPS (contacta a tu proveedor de hosting; suele ser gratis con Let’s Encrypt)
  2. Comprime las imágenes (usa TinyPNG.com, reduce el tamaño del archivo entre 60% y 80%)
  3. Agrega texto alternativo (describe lo que muestran las imágenes)
  4. Agrega marcado schema (usa un plugin o contrata a un desarrollador)

Mejora esperada: +15-25 puntos (42 → 60-67) después de corregir solo los problemas de gravedad alta

No intentes corregir los 62 problemas. Corrige los de gravedad alta (5-15 problemas) e ignora por ahora los de gravedad baja.


Problema 7: Site Audit encontró 62 problemas, ¿está roto mi sitio?

Síntoma: Site Audit enumera 62 problemas (se siente abrumador)

Diagnóstico: no todos los problemas son igual de importantes. Muchos son “deseables” de gravedad baja

Solución:

  1. Filtra por gravedad: busca la etiqueta “High Severity” (normalmente 5-15 problemas)
  2. Corrige solo los de gravedad alta (banderas rojas que dañan la experiencia del usuario)
  3. Ignora por ahora los de gravedad baja (banderas verdes = recomendaciones de buenas prácticas)

Desglose (sitio típico):

  • 5-15 de gravedad alta (corrígelos esta semana)
  • 15-30 de gravedad media (corrígelos este mes)
  • 20-40 de gravedad baja (corrígelos con el tiempo o nunca)

Más información: Primer informe de Site Audit: ¿y ahora qué?


Problema 8: Mi puntaje de Performance es 38, pero mi sitio me parece rápido

Síntoma: Site Audit muestra Performance 38/100, pero el sitio carga rápido en tu navegador

Diagnóstico: estás probando con wifi rápido y en computadora de escritorio. Site Audit prueba en móvil y con conexiones lentas.

Causas comunes:

  1. Móvil frente a escritorio (el móvil es de 2 a 3 veces más lento que el escritorio)
  2. Wifi rápido frente a 4G (tú tienes internet rápido, pero tus usuarios pueden tener 4G lento)
  3. Caché del navegador (ya visitaste el sitio antes, y quienes entran por primera vez no)

Solución:

  1. Prueba en móvil (un iPhone o Android real, no un navegador de escritorio)
  2. Prueba con una conexión lenta (limita la velocidad a “Slow 3G” en Chrome DevTools)
  3. Corrige los mayores cuellos de botella:
  • Comprime las imágenes (es lo que más impacto tiene)
  • Activa el almacenamiento en caché
  • Difiere el JavaScript no crítico

Mejora esperada: +10-20 puntos (38 → 50-58) solo con comprimir las imágenes


Problema 9: Site Audit dice que mi sitio tiene problemas de accesibilidad, pero no tenemos usuarios con discapacidad

Síntoma: Site Audit muestra Accessibility 52/100 y piensas “nuestros usuarios no tienen discapacidades”

Diagnóstico: las correcciones de accesibilidad ayudan a todos y reducen el riesgo de demandas bajo la ADA

Realidad:

  1. Entre el 15% y el 20% de la población tiene alguna discapacidad (visual, motriz, cognitiva)
  2. Las demandas bajo la ADA no exigen probar un daño (los abogados van tras los sitios que no cumplen)
  3. Las correcciones de accesibilidad ayudan a todos los usuarios (el texto alternativo ayuda a la IA a entender las imágenes, un buen contraste ayuda a quienes usan el móvil bajo el sol)

Corrige los problemas de accesibilidad de gravedad alta:

  1. Agrega texto alternativo a las imágenes (lectores de pantalla y visibilidad en IA)
  2. Agrega etiquetas a los campos de formulario (lectores de pantalla y usabilidad)
  3. Corrige el contraste de color (usuarios con baja visión y legibilidad en móvil)

Reducción de riesgo: cumplir con WCAG 2.1 AA reduce el riesgo de demandas bajo la ADA (acuerdo promedio: $10k-20k)


Problema 10: Los resultados de Site Audit difieren de Google Lighthouse

Síntoma: Site Audit muestra Performance 58 y Lighthouse muestra 85

Diagnóstico: Site Audit prueba en 9 navegadores y dispositivos móviles reales. Lighthouse prueba solo en Chrome (emulación de escritorio).

Por qué difieren los resultados:

  1. Variación entre navegadores (Firefox puede ser más lento que Chrome para la misma página)
  2. Móvil real frente a emulación (Site Audit prueba en iOS Safari real, Lighthouse emula)
  3. Navegadores integrados en apps (Site Audit prueba el navegador interno de Instagram y Facebook, Lighthouse no)

¿Cuál es más preciso? Ambos son precisos para lo que miden. Site Audit da un panorama más amplio (9 navegadores frente a 1).

Más información: Site Audit frente a Lighthouse


Problemas de Strategy

Problema 11: Los 6 modelos de IA dieron recomendaciones distintas

Síntoma: el informe de Strategy no muestra consenso (el CFO dice X, el COO dice Y, todos distintos)

Diagnóstico: tu pregunta es realmente ambigua (hay varios enfoques válidos y ninguna respuesta “correcta” clara)

Solución:

  1. Reúne más datos (ejecuta AI Visibility o Site Audit para tener contexto cuantitativo)
  2. Afina la pregunta (sé más específico sobre restricciones, metas y plazos)
  3. Ejecuta Strategy otra vez con el Intelligence Token de AI Visibility o Site Audit para un análisis cuantitativo
  4. O acepta la ambigüedad y elige según tu tolerancia al riesgo:
  • Si evitas el riesgo → sigue la recomendación del CFO/COO
  • Si buscas el riesgo → sigue la recomendación del Game Theorist/Market Realist

Ejemplo:

  • Pregunta original: “¿Deberíamos invertir en visibilidad en IA?” (demasiado vaga)
  • Mejor pregunta: “Tenemos un presupuesto de $50k, un plazo de 6 meses, un Presence Rate de 18% y competidores en 40%. ¿Deberíamos invertir en visibilidad en IA ($50k), en SEO tradicional ($50k) o en un modelo híbrido ($30k en IA + $20k en SEO)?”

Problema 12: El CFO y el COO dicen “demasiado riesgoso”, pero quiero hacerlo de todos modos

Síntoma: Strategy muestra al CFO y al COO escépticos, pero tú estás convencido de seguir adelante

Diagnóstico: los riesgos financieros y operativos son reales. Avanza con cautela o con mitigación.

Solución:

  1. Reconoce los riesgos (el CFO y el COO identificaron preocupaciones reales)
  2. Agrega estrategias de mitigación:
  • Reduce el presupuesto (prueba con $10k en lugar de $50k)
  • Amplía el plazo (12 meses en lugar de 6)
  • Construye primero un MVP (prototipo antes de la inversión completa)
  1. Ten un plan de respaldo (si falla, ¿cuál es el plan B?)
  2. O no lo hagas (a veces “no lo hagas” es la respuesta correcta)

Realidad: si 2 o más modelos coinciden en “demasiado riesgoso”, el riesgo es real. Mitígalo o acepta las consecuencias.


Problema 13: No entiendo qué significan las perspectivas de Game Theorist o Wildcard

Síntoma: el informe de Strategy muestra perspectivas que no entiendes

Definiciones:

  • CFO: enfoque financiero (retorno, costo, presupuesto)
  • COO: enfoque operativo (ejecución, capacidad del equipo, viabilidad)
  • Market Realist: enfoque competitivo (tendencias del mercado, comportamiento del cliente, momento)
  • Game Theorist: enfoque de dinámica estratégica (respuesta de la competencia, posicionamiento, teoría de juegos)
  • Chief Strategist: enfoque de alineación (metas, opciones abiertas, corrección sobre la marcha)
  • Wildcard: enfoque de casos extremos (riesgos poco convencionales, supuestos que podrían fallar)

Solución: concéntrate primero en las perspectivas que sí entiendes (CFO, COO). Si coinciden, eso basta para la mayoría de las decisiones.

Más información: Qué es el debate adversarial de IA


Problemas de API y automatización

Problema 14: La API de estado del informe devuelve 404 “Not found”

Síntoma: GET https://api.surmado.com/v1/reports/{report_id} devuelve 404

Causas comunes:

  1. report_id incorrecto (usa el report_id de la respuesta de creación del informe, no el Intelligence Token)
  2. Falta el prefijo /v1/ en la URL
  3. El informe pertenece a otra organización (las claves de API tienen alcance por organización)
  4. Falta la clave de API o es incorrecta (en ese caso se devuelve 401 Unauthorized, no 404)

Solución:

  1. Usa report_id, no el token: el endpoint es /v1/reports/{report_id} (por ejemplo, rpt_abc123xyz), no /intelligence/{token}. El campo token del informe (por ejemplo, SIG-2025-11-A1B2C) es un identificador, no una ruta de URL.
  2. Incluye Authorization: Bearer sur_live_YOUR_API_KEY (o X-API-Key: sur_live_...)
  3. Revisa los prefijos de los tokens cuando encadenes informes:
    • AI Visibility: SIG-YYYY-MM-XXXXX
    • Site Audit: SCN-YYYY-MM-XXXXX
    • Strategy: SOL-YYYY-MM-XXXXX
  4. Verifica en la app de Surmado que el informe exista en tu organización

Endpoint correcto: GET https://api.surmado.com/v1/reports/{report_id} con autenticación Bearer. Consulta la Guía de integración de la API.


Problema 15: La integración con Zapier, Make o n8n no se activa

Síntoma: la automatización no se ejecuta cuando se completa un informe de Surmado.

Causas comunes:

  1. No se incluyó webhook_url en la llamada a la API que crea el informe
  2. El endpoint del webhook devuelve un código que no es 2xx (Surmado reintenta 3 veces y luego se rinde)
  3. No se usó HTTPS en el endpoint del webhook (es obligatorio)
  4. Patrón alternativo con trigger de Gmail: el filtro de correo es demasiado específico (cambió el texto del asunto o la dirección del remitente es distinta)

Solución:

  1. Preferido: usa triggers basados en webhooks. Incluye webhook_url al crear el informe: el trigger “Catch Hook” (Zapier), “Custom Webhook” (Make) o “Webhook” (n8n) recibe directamente el payload de informe completado.
  2. Usa webhook.site como URL de prueba para confirmar que Surmado envía la estructura de payload esperada antes de armar la automatización.
  3. Verifica la expresión regular del token si lo extraes de un correo como alternativa:
    • AI Visibility: SIG-\d{4}-\d{2}-[A-Z0-9]{5}
    • Site Audit: SCN-\d{4}-\d{2}-[A-Z0-9]{5}
    • Strategy: SOL-\d{4}-\d{2}-[A-Z0-9]{5}
  4. Revisa las condiciones del filtro: el payload del webhook incluye event (por ejemplo, report.completed) y report.product (signal, scan o solutions). Filtra por estos campos.

Más información: Zapier, Make, n8n.


Problema 16: El análisis de JSON falla en el código o la automatización

Síntoma: la API devuelve JSON, pero tu analizador no encuentra los campos esperados.

Causas comunes:

  1. Mirar el nivel de anidación equivocado (el public_intelligence de AI Visibility y Site Audit tiene un resumen summary y un árbol data)
  2. Valores nulos (algunos campos son nulos hasta que el informe se completa o cuando no hay datos disponibles)
  3. Esperar que Strategy exponga public_intelligence: no lo hace; los datos de Strategy están en el PDF

Solución:

  1. Usa las rutas de campo correctas:

    • Resumen seleccionado: public_intelligence.summary.presence_score, public_intelligence.summary.seo_score
    • Árbol completo: public_intelligence.data.visibility_metrics.ghost_influence_percentage, public_intelligence.data.audit_data.lighthouse.performance_score
  2. Maneja los nulos de forma defensiva:

    summary = report.get("public_intelligence", {}).get("summary", {})
    authority_score = summary.get("authority_score") or 0
  3. Revisa la respuesta sin procesar con curl o con las herramientas de desarrollo del navegador antes de escribir el analizador

Más información: Datos estructurados e Intelligence Tokens, Guía de integración de la API


Problemas de entrega y facturación

Problema 17: El informe tarda más de lo esperado

Síntoma: pediste AI Visibility, Site Audit o Strategy hace 30 minutos y todavía no hay informe

Tiempos de entrega esperados:

  • AI Visibility: unos 15 minutos (típico)
  • Site Audit: unos 15 minutos (típico)
  • Strategy: unos 15 minutos (típico)

Si pasó más de 1 hora:

  1. Revisa la carpeta de spam (hi@surmado.com puede estar filtrado)
  2. Revisa la dirección de correo (verifica que la confirmación del pedido llegó al correo correcto)
  3. Espera 2 horas en total (depende de la carga, algunos informes tardan más)

Si pasaron más de 2 horas: escribe a hi@surmado.com con los datos de tu pedido

¿Y si algo salió mal? Tenemos sistemas de reembolso automático. Si eso no funciona, escribe a hi@surmado.com y lo resolveremos.


Problema 18: Me cobraron mal

Síntoma: el monto facturado no coincide con lo que esperabas

Solución: escribe de inmediato a hi@surmado.com con:

  • Fecha y hora del pedido
  • Correo electrónico usado
  • Nivel pedido frente al nivel cobrado

Haremos esto: reembolsar la diferencia en 1 a 2 días hábiles


Problema 19: El Intelligence Token no viene en el informe

Síntoma: recibiste el informe en PDF, pero sin Intelligence Token

Solución:

  1. Revisa el asunto del correo (el token está en el asunto: “Your AI Visibility Report - SIG-2025-11-A1B2C”)
  2. Revisa la página 1 del PDF (el token suele estar al inicio o al final)
  3. Busca en el PDF (Ctrl+F / Cmd+F para “SIG-”, “SCN-” o “SOL-”)

Si sigue faltando: escribe a hi@surmado.com con los datos de tu pedido


Cuándo contactar a soporte

Escribe a hi@surmado.com si:

  1. La entrega se retrasa más de 2 horas
  2. Tienes un problema de facturación (monto incorrecto, doble cobro)
  3. Falta el Intelligence Token en el informe
  4. La API devuelve 404 pero el formato del token es correcto
  5. El informe contiene errores (las métricas no tienen sentido, los datos parecen incorrectos)
  6. Quieres pedir un reembolso (dentro de los 7 días posteriores al pedido)
  7. Necesitas ayuda técnica con una integración (configuración de Zapier, Make, n8n)

Incluye en tu correo a soporte:

  • Intelligence Token (si lo tienes)
  • Fecha y hora del pedido
  • Correo electrónico usado en el pedido
  • Descripción concreta del problema
  • Capturas de pantalla (si ayudan)

Tiempo de respuesta esperado: 1 a 2 días hábiles (por lo general, más rápido)


Soluciones por tu cuenta (pruébalas primero)

Antes de contactar a soporte, prueba esto:

Para AI Visibility:

  1. Lee Primer informe de AI Visibility: ¿y ahora qué?
  2. Comprueba si un Presence Rate de 0% es normal (negocio nuevo o local)
  3. Verifica que un Authority Score nulo sea lo esperado (si el Presence Rate es 0%)

Para Site Audit:

  1. Lee Primer informe de Site Audit: ¿y ahora qué?
  2. Filtra solo por problemas de gravedad alta (no intentes corregir los 62)
  3. Verifica que un Overall Score < 70 se puede corregir (no está roto)

Para Strategy:

  1. Lee Primer informe de Strategy: ¿y ahora qué?
  2. Busca consenso (4 o más modelos de acuerdo)
  3. Concéntrate en las perspectivas del CFO y el COO si las demás no te quedan claras

Para la API:

  1. Prueba el endpoint del informe con curl: curl https://api.surmado.com/v1/reports/{report_id} -H "Authorization: Bearer sur_live_YOUR_API_KEY"
  2. Revisa el formato del token (sin espacios, con el prefijo correcto: SIG-, SCN- o SOL-)
  3. Lee Datos estructurados e Intelligence Tokens y la Guía de integración de la API

Malentendidos comunes

“Mi Presence Rate es 18%, ¿significa que estoy fallando?”

No. 18% es el punto de partida de muchas pymes. Significa que la IA te menciona en el 18% de las consultas de los clientes. Tu meta: mejorar a 25%, 35%, 45% con el tiempo. No es un fracaso, es un punto de partida.


“Site Audit encontró 62 problemas, ¿significa que mi sitio es terrible?”

No. La mayoría de los sitios tienen entre 40 y 80 problemas (si los pruebas a fondo). De ellos, 5-15 son de gravedad alta (corrígelos). Entre 20 y 40 son de gravedad baja (deseables, no urgentes). No te alarmes.


“Strategy me dio 3 recomendaciones distintas, ¿cuál es la correcta?”

Todas son válidas. La recomendación n.º 1 tiene el mayor consenso. La n.º 2 y la n.º 3 son alternativas (con distintos perfiles de riesgo y recompensa). Elige según tus prioridades (tolerancia al riesgo, presupuesto, plazo).


“Mi competidor aparece n.º 1 pero da peor servicio, ¿por qué?”

La IA ve lo que está publicado, no la realidad. Si tu competidor tiene mejor marcado schema, más contenido y un posicionamiento más claro en su sitio, la IA lo recomendará aunque tu servicio sea objetivamente mejor. Corrige lo que la IA ve (tu sitio web).


“¿Mi Intelligence Token es una contraseña?”

No. El token es un identificador, no una llave. Para leer los datos de un informe se necesita tu clave de API (Authorization: Bearer sur_live_YOUR_API_KEY), así que un token por sí solo no abre nada. Mantén tu clave de API en privado.


¿Sigues atascado? Escribe a hi@surmado.com con tu Intelligence Token y el problema específico. Te ayudaremos. Si algo salió mal con tu informe, lo resolveremos.