> ## 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. # Integração SIGAVI 360 — Missões e Leads > Como conectar o seu SIGAVI 360 ao Play2sell para que as atividades dos corretores contem nas missões e as fichas de atendimento virem leads — usuário de integração, etapas do funil, o que é lido, de quanto em quanto tempo, FAQ e solução de problemas. Configuração por telas, sem programação. A **integração SIGAVI 360** conecta o seu **SIGAVI** ao **Play2sell** para duas coisas: * **Missões** — atividades, visitas e eventos que os corretores registram no SIGAVI contam para as missões da gamificação. * **Leads** — cada **ficha de atendimento (FAC)** do SIGAVI vira um **lead** no Play2sell, com o corretor responsável e a etapa do funil. A configuração é feita **por telas, sem programação**, e leva cerca de **10 minutos**. **O SIGAVI é a fonte da verdade.** O Play2sell **só lê** o seu SIGAVI — nada é criado, alterado ou apagado lá. A leitura acontece **de 10 em 10 minutos**: o que o corretor registra no SIGAVI aparece no Play2sell em até 10 minutos. ## O que você vai configurar | Passo | O que você faz | Resultado | | - | - | - | | **1** | Pega o **usuário de integração** no seu SIGAVI | a credencial de leitura da conexão | | **2** | Conecta o SIGAVI no painel Play2sell | acesso conferido na hora | | **3** | Escolhe o que ligar e a etapa de cada situação | missões e leads sincronizados | | **4** | Confere a primeira leitura | integração validada | **Pré-requisitos** * Ser **administrador** da empresa no Play2sell (só administradores ligam ou desligam a integração). * Ter o **usuário de integração** do seu SIGAVI — é o usuário da API, **não** o seu login pessoal. * Os corretores cadastrados no Play2sell com o **mesmo e‑mail** (ou o mesmo **CPF/CNPJ**) que têm no SIGAVI. ## Como funciona a integração? Ele registra atividades, visitas e atendimentos como sempre fez. A cada 10 minutos o Play2sell consulta o seu SIGAVI e traz o que foi criado ou alterado desde a leitura anterior. Cada leitura recua alguns minutos sobre a anterior, para não perder nada que tenha sido gravado no meio do caminho — o que vier repetido é reconhecido e não conta duas vezes. Cada atividade, visita ou evento é atribuído ao corretor que a registrou e fica disponível para as missões da sua empresa. Cada ficha de atendimento vira um lead. Quando a ficha muda de situação no SIGAVI, o lead acompanha, indo para a etapa do funil que você escolheu. ### Como o corretor é identificado | Registro | Como o Play2sell acha o corretor | | - | - | | **Atividades, visitas e eventos** (missões) | pelo **e‑mail** do corretor no SIGAVI; se não achar, pelo **CPF/CNPJ** dele no SIGAVI | | **Ficha de atendimento** (responsável pelo lead) | pelo **e‑mail** do corretor no SIGAVI | Um registro cujo corretor não é encontrado **não gera pontos**, e o lead fica **sem responsável**. Para evitar isso, mantenha o e‑mail e o CPF dos corretores iguais nos dois sistemas. Se a mesma pessoa estiver cadastrada **duas vezes** no Play2sell (uma com o e‑mail, outra com o CPF), o registro vai para o cadastro encontrado pelo **e‑mail**. Vale unificar cadastros duplicados antes de conectar. ## Passo 1 — Obter o usuário de integração no SIGAVI A conexão precisa de três valores: **endereço**, **usuário de integração** e **senha**. Com o seu login de administrador, acesse `suaempresa.sigavi360.com.br/Help` (troque `suaempresa` pelo endereço do seu SIGAVI). Na página de ajuda, use a opção de **visualizar** o usuário e a senha de integração e copie os dois valores. É a parte **antes** de `.sigavi360.com.br` — em `suaempresa.sigavi360.com.br`, o endereço é `suaempresa`. Você tem em mãos **endereço**, **usuário de integração** e **senha**. A senha de integração é **sensível** — trate como qualquer senha. No Play2sell ela é guardada e **nunca mais é exibida**. Se não encontrar a credencial de integração na ajuda do SIGAVI, peça ao suporte do SIGAVI o **usuário da API** da sua empresa. ## Passo 2 — Conectar no painel Play2sell No painel Play2sell, vá em **Integrações → Conectores**, encontre o **SIGAVI 360** e clique em **Conectar**. | Campo | O que informar | | - | - | | **Endereço do SIGAVI** | A parte antes de `.sigavi360.com.br` (ex.: `suaempresa`). Se colar o endereço completo, o painel aproveita só essa parte. | | **Usuário de integração** | O usuário da API copiado no Passo 1. | | **Senha** | A senha de integração. | Ao clicar em **Continuar**, o Play2sell **confere o acesso na hora** no seu SIGAVI. Se o usuário ou a senha não entrarem, você vê o motivo ali mesmo e nada é salvo. ## Passo 3 — Escolher o que ligar Depois de conferir o acesso, o painel mostra o que pode ser ligado: | Opção | O que faz | | - | - | | **Missões** | Atividades, visitas e eventos dos corretores no SIGAVI contam para as missões. | | **Leads** | Cada ficha de atendimento do SIGAVI vira um lead, com o corretor responsável. | Você pode ligar as duas ou só uma. ### Etapa do funil para cada situação Com **Leads** ligado, o painel lista as **situações de atendimento do seu SIGAVI** — lidas da sua conta, com os nomes que a sua empresa usa — e, ao lado de cada uma, as **etapas do seu funil de leads** no Play2sell. * Quando existe uma etapa com **o mesmo nome** da situação, ela já vem escolhida. * Para as demais, escolha a etapa — ou deixe **"Manter a etapa em que o lead está"**. | Situação da ficha no SIGAVI | O que acontece com o lead | | - | - | | Tem etapa escolhida | O lead vai para essa etapa sempre que a ficha estiver nessa situação. | | "Manter a etapa em que o lead está" | Lead novo entra na **primeira etapa** do funil; lead que já existe **fica onde está**. | Clique em **Conectar**. A primeira leitura sai em até 10 minutos. Não precisa mapear tudo de uma vez. Você pode voltar depois, em **Editar configuração**, e ajustar as etapas — as escolhas já feitas vêm preenchidas. ## Passo 4 — Conferir a primeira leitura A primeira leitura traz as fichas alteradas nas **últimas 24 horas** e as atividades das **últimas 2 horas**. O que é mais antigo que isso não é importado. Abra o funil de leads e procure um atendimento recente do SIGAVI: nome, contato, corretor responsável e etapa devem bater. Peça a um corretor para registrar uma atividade no SIGAVI e, depois de 10 minutos, veja o progresso dele nas missões. ## O que é lido do SIGAVI | Do SIGAVI | Vira no Play2sell | Observação | | - | - | - | | Ficha de atendimento (FAC) | **Lead** | Nome, e‑mail e telefone do cliente, corretor responsável e situação. Uma ficha, um lead. | | Ficha **cadastrada** | Evento para as missões | Conta **uma vez** por ficha, no momento do cadastro. Não leva nome nem contato do cliente. | | Atividades da ficha | Eventos para as missões | Atribuídos ao corretor da atividade. | | Visitas | Eventos para as missões | Atribuídos ao corretor da visita. | | Eventos da ficha | Eventos para as missões | Atribuídos ao corretor do evento. | ### Regras do lead * **Uma ficha, um lead.** Se a mesma ficha for lida de novo, o lead é atualizado — não é duplicado. * **Nome e contato vêm do SIGAVI.** Um campo que chega **vazio** do SIGAVI **não apaga** o que já está no lead. * **O que você enriqueceu no Play2sell fica.** Valor, documento e outros dados preenchidos no Play2sell não são sobrescritos pela leitura. * **Exclusões não são espelhadas.** Uma ficha apagada no SIGAVI continua como lead no Play2sell. ## Editar ou desligar Em **Integrações → Conectores → SIGAVI 360 → Editar configuração**: * **Rever a configuração:** informe a senha de integração de novo (ela não fica visível depois de salva), ajuste o que quiser e salve. * **Desligar integração:** as leituras param. **Leads e pontos que já entraram continuam** no Play2sell, e você pode ligar de novo quando quiser — a leitura retoma de onde parou. ## Perguntas frequentes Em até **10 minutos**. O SIGAVI não avisa quando algo muda, então o Play2sell consulta de 10 em 10 minutos. **Não.** A integração é somente leitura. Só se a situação da ficha no SIGAVI tiver uma **etapa escolhida** no mapeamento — nesse caso o SIGAVI manda. Se a situação estiver em "Manter a etapa em que o lead está", o lead fica onde você colocou. Fichas nessa situação continuam virando leads, e o lead fica na etapa em que está. Para direcioná-la a uma etapa, abra **Editar configuração**: a situação nova aparece na lista. Não. A integração começa a contar a partir da conexão (com as janelas do Passo 4). Não. Cada registro do SIGAVI tem uma identificação própria; o que é lido de novo é reconhecido e ignorado. Ainda **não está disponível** para o SIGAVI. Esta integração cobre Missões e Leads. ## Solução de problemas | O que aparece | Causa provável | O que fazer | | - | - | - | | "O SIGAVI recusou o usuário ou a senha." | Usuário ou senha de integração incorretos, ou foi usado o login pessoal. | Copie de novo a credencial de integração na ajuda da API do SIGAVI (Passo 1). | | "O SIGAVI aceitou o usuário, mas não deixou ler os dados." | O usuário informado não é o de integração. | Use o usuário da API, não o login pessoal. | | "Endereço do SIGAVI inválido." | Foi informado algo além do endereço da sua empresa. | Informe só a parte antes de `.sigavi360.com.br`. | | "Resposta inesperada do SIGAVI…" | A API do seu SIGAVI está fora do ar ou com erro. | Tente de novo em alguns minutos. Se persistir, peça ao suporte do SIGAVI para conferir a API da sua empresa. | | "Há situações em etapas que não são do funil de leads desta empresa." | Uma etapa do funil foi removida enquanto a tela estava aberta. | Feche e abra a configuração de novo e refaça a escolha. | | Lead sem corretor responsável | O corretor da ficha não foi encontrado no Play2sell. | Confira se o e‑mail do corretor é o mesmo nos dois sistemas. | | Atividade não contou na missão | O corretor não foi encontrado, ou não há missão que conte aquele tipo de atividade. | Confira o cadastro do corretor e as missões ativas da empresa. | ## Referência | Item | Valor | | - | - | | Sentido | SIGAVI → Play2sell (somente leitura) | | Frequência | de 10 em 10 minutos | | Primeira leitura | fichas das últimas 24 horas; atividades das últimas 2 horas | | Identidade do corretor | e‑mail; nas atividades, na falta do e‑mail, CPF/CNPJ | | Identidade do lead | número interno da ficha no SIGAVI | | Quem pode configurar | administradores da empresa | This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.