> For the complete documentation index, see [llms.txt](https://docs.patagon.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.patagon.ai/solucao-de-problemas/crm-integration/crm-lead-field-sync.md). # Como os campos de leads são sincronizados com seu CRM Quando a sincronização com o CRM está habilitada e configurada, a Patagon AI envia automaticamente os dados salvos do lead enquanto o agente processa a conversa. Os campos de identificação padrão são enviados automaticamente, enquanto outros atributos exigem um mapeamento de campo do CRM ou um modelo de requisição personalizado. A sincronização não se limita a leads qualificados nem a mudanças de status. ## Quando a sincronização acontece A Patagon AI inicia uma sincronização depois de processar com sucesso novos dados da conversa. O envio acontece em segundo plano, por isso pode levar um pouco de tempo, e falhas temporárias são repetidas automaticamente. Um lead não precisa ser qualificado nem mudar de status para que uma sincronização aconteça. ## O que é sincronizado | Categoria | O que é enviado | Condição | | ------------------------------------- | --------------------------------------------------- | -------------------------------------------------------------------------- | | Identificação padrão | Nome, sobrenome, email e telefone | Enviados automaticamente. As conexões da ApiDeck exigem os quatro valores. | | Atributos personalizados e do sistema | O valor salvo do atributo | O atributo tem um valor e um mapeamento em **Campo do CRM**. | | Atributos de valor fixo | O valor fixo configurado | O atributo tem um mapeamento em **Campo do CRM**. | | Campos HTTP personalizados | Qualquer atributo disponível referenciado pelo slug | O modelo de requisição configurado determina quais campos são enviados. | Valores de seleção múltipla são enviados como texto separado por vírgulas. Números e valores de sim/não também são enviados como texto quando usados em campos personalizados do CRM. Valores vazios são ignorados. ## Como mapear um atributo para um campo do CRM 1. Acesse **Agente > Atributos**. 2. Edite o atributo que você quer sincronizar. 3. Abra **Mais opções**. 4. Selecione o destino em **Campo do CRM**. 5. Salve o atributo. Atributos de valor fixo mapeados são sincronizados da mesma forma que os outros atributos mapeados. Alterar um mapeamento não atualiza imediatamente os registros existentes no CRM; o novo mapeamento é aplicado na próxima sincronização elegível. Entre em contato com o suporte se precisar preencher ou repetir a sincronização de dados históricos. ## Criar ou atualizar Na primeira sincronização bem-sucedida, a Patagon AI cria ou encontra o lead ou contato no seu CRM e salva o ID do registro no CRM. As sincronizações seguintes usam esse ID para atualizar o mesmo registro, em vez de criar uma duplicata. ## O que não é sincronizado e por quê Alguns campos ou leads podem não ser sincronizados quando: * Um atributo não tem um mapeamento em **Campo do CRM**. * O valor está vazio ou ainda não foi capturado. * A sincronização está desativada, não há um destino ativo ou a conexão, as credenciais ou a configuração são inválidas. * Uma conexão da ApiDeck não tem algum dado de identificação obrigatório: nome, sobrenome, email ou telefone. * Você alterou um mapeamento, mas nenhuma conversa elegível foi processada desde a mudança. * O destino automático configurado não é uma entidade de contato ou lead compatível. A pontuação de qualificação, a atribuição e todas as colunas exibidas no painel da Patagon AI não são campos padrão universais. Elas só são enviadas quando a conexão, o mapeamento de atributos ou o modelo de requisição personalizado inclui os dados correspondentes. ## Exemplo Suponha que você mapeie o atributo **Orçamento** da Patagon AI para o campo `annual_budget` do CRM. Quando a conversa capturar um orçamento, a próxima sincronização enviará esse valor. Se nenhum orçamento tiver sido capturado, a Patagon AI não enviará esse campo. ## Se um campo estiver faltando 1. Confirme se a sincronização com o CRM está habilitada e se o destino está ativo. 2. Verifique se o lead tem todos os campos de identificação exigidos pela sua conexão. 3. Abra o atributo e confirme o mapeamento em **Campo do CRM**. 4. Confirme se o atributo tem um valor salvo. 5. Se você alterou o mapeamento recentemente, aguarde a próxima atualização de conversa que possa iniciar uma sincronização. 6. Para uma conexão HTTP personalizada, verifique se o modelo de requisição referencia o slug do atributo. Se o campo continuar faltando, entre em contato com . Inclua o nome do CRM, um lead de exemplo e o atributo da Patagon AI e o campo do CRM que estão faltando. Nunca envie senhas, chaves de API ou outros segredos. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.patagon.ai/solucao-de-problemas/crm-integration/crm-lead-field-sync.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.