> ## Documentation Index
> Fetch the complete documentation index at: https://docs.play2sell.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Integración SIGAVI 360 — Misiones y Leads

> Cómo conectar tu SIGAVI 360 a Play2sell para que las actividades de los corredores cuenten en las misiones y las fichas de atención se conviertan en leads — usuario de integración, etapas del embudo, qué se lee, cada cuánto tiempo, FAQ y solución de problemas. Configuración por pantallas, sin programación.

La **integración SIGAVI 360** conecta tu **SIGAVI** a **Play2sell** para dos cosas:

* **Misiones** — actividades, visitas y eventos que los corredores registran en el SIGAVI cuentan para las misiones de la gamificación.
* **Leads** — cada **ficha de atención (FAC)** del SIGAVI se convierte en un **lead** en Play2sell, con el corredor responsable y la etapa del embudo.

La configuración se hace **por pantallas, sin programación**, y toma alrededor de **10 minutos**.

<Note>
  **El SIGAVI es la fuente de la verdad.** Play2sell **solo lee** tu SIGAVI — nada se crea, se modifica ni se borra allí. La lectura ocurre **cada 10 minutos**: lo que el corredor registra en el SIGAVI aparece en Play2sell en hasta 10 minutos.
</Note>

## Qué vas a configurar

| Paso | Qué haces | Resultado |
| - | - | - |
| **1** | Obtienes el **usuario de integración** en tu SIGAVI | la credencial de lectura de la conexión |
| **2** | Conectas el SIGAVI en el panel Play2sell | acceso verificado al instante |
| **3** | Eliges qué activar y la etapa de cada situación | misiones y leads sincronizados |
| **4** | Verificas la primera lectura | integración validada |

<Note>
  **Requisitos previos**

  * Ser **administrador** de la empresa en Play2sell (solo los administradores activan o desactivan la integración).
  * Tener el **usuario de integración** de tu SIGAVI — es el usuario de la API, **no** tu login personal.
  * Los corredores registrados en Play2sell con el **mismo correo** (o el mismo **CPF/CNPJ**) que tienen en el SIGAVI.
</Note>

## ¿Cómo funciona la integración?

<Steps>
  <Step title="El corredor trabaja en el SIGAVI">
    Registra actividades, visitas y atenciones como siempre lo ha hecho.
  </Step>

  <Step title="Play2sell lee lo que cambió">
    Cada 10 minutos Play2sell consulta tu SIGAVI y trae lo que fue creado o modificado desde la lectura anterior. Cada lectura retrocede algunos minutos sobre la anterior, para no perder nada que se haya grabado a mitad de camino — lo que venga repetido se reconoce y no cuenta dos veces.
  </Step>

  <Step title="Las actividades cuentan en las misiones">
    Cada actividad, visita o evento se atribuye al corredor que lo registró y queda disponible para las misiones de tu empresa.
  </Step>

  <Step title="Las fichas se convierten en leads">
    Cada ficha de atención se convierte en un lead. Cuando la ficha cambia de situación en el SIGAVI, el lead la acompaña, yendo a la etapa del embudo que elegiste.
  </Step>
</Steps>

### Cómo se identifica al corredor

| Registro | Cómo Play2sell encuentra al corredor |
| - | - |
| **Actividades, visitas y eventos** (misiones) | por el **correo** del corredor en el SIGAVI; si no lo encuentra, por su **CPF/CNPJ** en el SIGAVI |
| **Ficha de atención** (responsable del lead) | por el **correo** del corredor en el SIGAVI |

Un registro cuyo corredor no se encuentra **no genera puntos**, y el lead queda **sin responsable**. Para evitarlo, mantén el correo y el CPF de los corredores iguales en los dos sistemas.

<Warning>
  Si la misma persona está registrada **dos veces** en Play2sell (una con el correo, otra con el CPF), el registro va al registro de usuario encontrado por el **correo**. Conviene unificar los registros duplicados antes de conectar.
</Warning>

## Paso 1 — Obtener el usuario de integración en el SIGAVI

La conexión necesita tres valores: **dirección**, **usuario de integración** y **contraseña**.

<Steps>
  <Step title="Abre la ayuda de la API de tu SIGAVI">
    Con tu login de administrador, accede a `tuempresa.sigavi360.com.br/Help` (cambia `tuempresa` por la dirección de tu SIGAVI).
  </Step>

  <Step title="Visualiza la credencial de integración">
    En la página de ayuda, usa la opción de **visualizar** el usuario y la contraseña de integración y copia los dos valores.
  </Step>

  <Step title="Anota la dirección">
    Es la parte **antes** de `.sigavi360.com.br` — en `tuempresa.sigavi360.com.br`, la dirección es `tuempresa`.
  </Step>
</Steps>

<Check>Tienes a mano **dirección**, **usuario de integración** y **contraseña**.</Check>

<Note>
  La contraseña de integración es **sensible** — trátala como cualquier contraseña. En Play2sell se guarda y **nunca más se muestra**. Si no encuentras la credencial de integración en la ayuda del SIGAVI, pide al soporte del SIGAVI el **usuario de la API** de tu empresa.
</Note>

## Paso 2 — Conectar en el panel Play2sell

En el panel Play2sell, ve a **Integrações → Conectores**, encuentra el **SIGAVI 360** y haz clic en **Conectar**.

| Campo | Qué informar |
| - | - |
| **Endereço do SIGAVI** (Dirección del SIGAVI) | La parte antes de `.sigavi360.com.br` (ej.: `tuempresa`). Si pegas la dirección completa, el panel aprovecha solo esa parte. |
| **Usuário de integração** (Usuario de integración) | El usuario de la API copiado en el Paso 1. |
| **Senha** (Contraseña) | La contraseña de integración. |

Al hacer clic en **Continuar**, Play2sell **verifica el acceso al instante** en tu SIGAVI. Si el usuario o la contraseña no entran, ves el motivo allí mismo y nada se guarda.

## Paso 3 — Elegir qué activar

Después de verificar el acceso, el panel muestra lo que se puede activar:

| Opción | Qué hace |
| - | - |
| **Missões** (Misiones) | Las actividades, visitas y eventos de los corredores en el SIGAVI cuentan para las misiones. |
| **Leads** | Cada ficha de atención del SIGAVI se convierte en un lead, con el corredor responsable. |

Puedes activar las dos o solo una.

### Etapa del embudo para cada situación

Con **Leads** activado, el panel lista las **situaciones de atención de tu SIGAVI** — leídas de tu cuenta, con los nombres que usa tu empresa — y, al lado de cada una, las **etapas de tu embudo de leads** en Play2sell.

* Cuando existe una etapa con **el mismo nombre** que la situación, ya viene elegida.
* Para las demás, elige la etapa — o deja **"Manter a etapa em que o lead está"** (Mantener la etapa en la que está el lead).

| Situación de la ficha en el SIGAVI | Qué pasa con el lead |
| - | - |
| Tiene etapa elegida | El lead va a esa etapa siempre que la ficha esté en esa situación. |
| "Manter a etapa em que o lead está" | Un lead nuevo entra en la **primera etapa** del embudo; un lead que ya existe **se queda donde está**. |

Haz clic en **Conectar**. La primera lectura sale en hasta 10 minutos.

<Tip>
  No hace falta mapear todo de una vez. Puedes volver después, en **Editar configuração** (Editar configuración), y ajustar las etapas — las elecciones ya hechas vienen completadas.
</Tip>

## Paso 4 — Verificar la primera lectura

<Steps>
  <Step title="Espera hasta 10 minutos">
    La primera lectura trae las fichas modificadas en las **últimas 24 horas** y las actividades de las **últimas 2 horas**. Lo que es más antiguo que eso no se importa.
  </Step>

  <Step title="Verifica un lead">
    Abre el embudo de leads y busca una atención reciente del SIGAVI: nombre, contacto, corredor responsable y etapa deben coincidir.
  </Step>

  <Step title="Verifica una actividad">
    Pide a un corredor que registre una actividad en el SIGAVI y, después de 10 minutos, mira su progreso en las misiones.
  </Step>
</Steps>

## Qué se lee del SIGAVI

| Del SIGAVI | Se convierte en Play2sell en | Observación |
| - | - | - |
| Ficha de atención (FAC) | **Lead** | Nombre, correo y teléfono del cliente, corredor responsable y situación. Una ficha, un lead. |
| Ficha **registrada** | Evento para las misiones | Cuenta **una vez** por ficha, en el momento del registro. No lleva nombre ni contacto del cliente. |
| Actividades de la ficha | Eventos para las misiones | Atribuidos al corredor de la actividad. |
| Visitas | Eventos para las misiones | Atribuidos al corredor de la visita. |
| Eventos de la ficha | Eventos para las misiones | Atribuidos al corredor del evento. |

### Reglas del lead

* **Una ficha, un lead.** Si la misma ficha se lee de nuevo, el lead se actualiza — no se duplica.
* **Nombre y contacto vienen del SIGAVI.** Un campo que llega **vacío** del SIGAVI **no borra** lo que ya está en el lead.
* **Lo que enriqueciste en Play2sell se queda.** Monto, documento y otros datos completados en Play2sell no son sobrescritos por la lectura.
* **Las eliminaciones no se reflejan.** Una ficha borrada en el SIGAVI continúa como lead en Play2sell.

## Editar o desactivar

En **Integrações → Conectores → SIGAVI 360 → Editar configuração**:

* **Revisar la configuración:** informa la contraseña de integración de nuevo (no queda visible después de guardada), ajusta lo que quieras y guarda.
* **Desligar integração** (Desactivar integración)**:** las lecturas se detienen. **Los leads y puntos que ya entraron continúan** en Play2sell, y puedes activarla de nuevo cuando quieras — la lectura se retoma desde donde se detuvo.

## Preguntas frecuentes

<AccordionGroup>
  <Accordion title="¿En cuánto tiempo aparece en Play2sell lo que hago en el SIGAVI?">
    En hasta **10 minutos**. El SIGAVI no avisa cuando algo cambia, así que Play2sell consulta cada 10 minutos.
  </Accordion>

  <Accordion title="¿Play2sell modifica algo en mi SIGAVI?">
    **No.** La integración es de solo lectura.
  </Accordion>

  <Accordion title="Moví el lead de etapa en Play2sell. ¿La lectura lo va a deshacer?">
    Solo si la situación de la ficha en el SIGAVI tiene una **etapa elegida** en el mapeo — en ese caso manda el SIGAVI. Si la situación está en "Manter a etapa em que o lead está", el lead se queda donde lo pusiste.
  </Accordion>

  <Accordion title="Creamos una situación nueva en el SIGAVI. ¿Y ahora?">
    Las fichas en esa situación siguen convirtiéndose en leads, y el lead se queda en la etapa en la que está. Para dirigirla a una etapa, abre **Editar configuração**: la situación nueva aparece en la lista.
  </Accordion>

  <Accordion title="¿Entran las actividades antiguas de los corredores?">
    No. La integración empieza a contar a partir de la conexión (con las ventanas del Paso 4).
  </Accordion>

  <Accordion title="¿La misma actividad puede contar dos veces?">
    No. Cada registro del SIGAVI tiene una identificación propia; lo que se lee de nuevo se reconoce y se ignora.
  </Accordion>

  <Accordion title="¿Y el pago de comisiones (Pagaduría)?">
    Todavía **no está disponible** para el SIGAVI. Esta integración cubre Misiones y Leads.
  </Accordion>
</AccordionGroup>

## Solución de problemas

| Qué aparece | Causa probable | Qué hacer |
| - | - | - |
| "O SIGAVI recusou o usuário ou a senha." (El SIGAVI rechazó el usuario o la contraseña.) | Usuario o contraseña de integración incorrectos, o se usó el login personal. | Copia de nuevo la credencial de integración en la ayuda de la API del SIGAVI (Paso 1). |
| "O SIGAVI aceitou o usuário, mas não deixou ler os dados." (El SIGAVI aceptó el usuario, pero no dejó leer los datos.) | El usuario informado no es el de integración. | Usa el usuario de la API, no el login personal. |
| "Endereço do SIGAVI inválido." (Dirección del SIGAVI inválida.) | Se informó algo más que la dirección de tu empresa. | Informa solo la parte antes de `.sigavi360.com.br`. |
| "Resposta inesperada do SIGAVI…" (Respuesta inesperada del SIGAVI…) | La API de tu SIGAVI está fuera de servicio o con error. | Intenta de nuevo en algunos minutos. Si persiste, pide al soporte del SIGAVI que verifique la API de tu empresa. |
| "Há situações em etapas que não são do funil de leads desta empresa." (Hay situaciones en etapas que no son del embudo de leads de esta empresa.) | Una etapa del embudo fue eliminada mientras la pantalla estaba abierta. | Cierra y abre la configuración de nuevo y rehaz la elección. |
| Lead sin corredor responsable | El corredor de la ficha no fue encontrado en Play2sell. | Verifica si el correo del corredor es el mismo en los dos sistemas. |
| La actividad no contó en la misión | El corredor no fue encontrado, o no hay misión que cuente ese tipo de actividad. | Verifica el registro del corredor y las misiones activas de la empresa. |

## Referencia

| Ítem | Valor |
| - | - |
| Sentido | SIGAVI → Play2sell (solo lectura) |
| Frecuencia | cada 10 minutos |
| Primera lectura | fichas de las últimas 24 horas; actividades de las últimas 2 horas |
| Identidad del corredor | correo; en las actividades, a falta del correo, CPF/CNPJ |
| Identidad del lead | número interno de la ficha en el SIGAVI |
| Quién puede configurar | administradores de la empresa |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.