--- title: Integração com Ferramentas Externas info: Esses fluxos de trabalho focam em trazer dados para dentro e para fora do Twenty através de chamadas de API e webhooks. image: /images/user-guide/integrations/plug.png sectionInfo: Automatize processos e integre com ferramentas externas --- Header Abaixo estão exemplos de fluxos de trabalho que você poderia implementar para conectar o Twenty com o restante do seu stack. ## Casos de Uso de Ingestão de Dados ### Envio de Formulários Web **Problema**: Você precisa capturar leads de formulários do site, landing pages ou formulários de contato diretamente no Twenty. **Solução**: Use gatilhos de webhook para criar registros dos envios de formulários automaticamente. **Configuração**: - Crie um fluxo de trabalho com um gatilho de webhook - Configure o webhook para receber dados do formulário (nome, email, empresa, etc.) - Defina o método do webhook para POST - Defina a estrutura esperada do corpo no gatilho **Gatilho**: Webhook (requisição POST do seu formulário) **Ações**: - Pesquisar Registros para verificar se a pessoa/empresa já existe - Ramificação: Se existir → Atualizar Registro, Se não existir → Criar Registro - Criar Registro para tarefa de acompanhamento atribuída ao representante de vendas - Enviar notificação por email para a equipe de vendas ### Sincronização de Dados do Produto **Problema**: Sua equipe de vendas precisa de visibilidade sobre dados de uso do produto, faturamento ou adoção de recursos armazenados em seu data warehouse. **Solução**: Sincronize regularmente os dados do produto no Twenty para fornecer aos vendedores contexto sobre suas contas. **Gatilho**: Em um cronograma (diário ou semanal) **Ações**: - Requisição HTTP para a API do seu data warehouse - Ação de código para processar e formatar os dados - Use a função Iterador para as etapas seguintes - Pesquisar Registros para encontrar registros de empresas correspondentes - Atualizar Registro para adicionar métricas de uso do produto - Criar Registro para tarefas quando o uso cair abaixo do limite ### Notas de Reunião a partir de Gravadores de Chamadas **Problema**: Percepções importantes das chamadas de vendas se perdem ou não são documentadas corretamente no CRM. **Solução**: Crie automaticamente notas e itens de ação a partir de sistemas de gravação de chamadas. **Gatilho**: Webhook (da plataforma de gravação de chamadas) **Ações**: - Ação de código para extrair resumo da reunião e itens de ação - Pesquisar Registros para encontrar a oportunidade ou contato relacionado - Criar Registro para uma nota com resumo da reunião - Criar Registro para tarefas de acompanhamento com base nos itens de ação - Enviar Email para os participantes com resumo e próximos passos ### Enriquecimento de Dados **Problema**: Seus registros de contato e empresa carecem de informações demográficas e firmográficas importantes. **Solução**: Enriqueça automaticamente registros usando provedores de dados externos. **Gatilho**: Registro é Criado (objeto Pessoas ou Empresas) **Ações**: - Requisição HTTP para a API de enriquecimento - Ação de código para processar a resposta de enriquecimento - Use a função Iterador para as etapas seguintes - Atualizar Registro com informações adicionais da empresa/contato - Criar Registro para tarefa de vendas se prospecto de alto valor for identificado - Enviar alerta por Email se o enriquecimento revelar sinais de compra chave ## Casos de Uso de Distribuição de Dados ### Gestão de Assinantes da Newsletter **Problema**: Você deseja enviar e-mails de marketing para segmentos específicos dos dados do seu CRM usando ferramentas de e-mail especializadas. **Solução**: Exporte listas de assinantes para sua plataforma de marketing por e-mail quando necessário. **Configuração**: Crie uma visualização no Twenty com todos os destinatários da newsletter **Gatilho**: Lançamento Manual (quando nenhum registro é selecionado) **Ações**: - Pesquisar Registros usando os critérios de visualização da newsletter - Ação de código para formatar endereços de e-mail para sua plataforma de email - Requisição HTTP para adicionar assinantes à sua ferramenta de marketing por e-mail - Criar Registro para rastreamento de campanhas - Enviar confirmação por e-mail para a equipe de marketing ### Gatilhos de Sequência de Emails **Problema**: Você deseja acionar sequências de e-mail sofisticadas baseadas em eventos do CRM usando ferramentas de automação de e-mail dedicadas. **Solução**: Envie novos leads ou clientes para sua plataforma de automação de e-mail quando eventos específicos ocorrerem. **Gatilho**: Registro é Criado (objeto Pessoas com critérios específicos) **Ações**: - Ação de código para determinar a sequência de e-mail apropriada - Requisição HTTP para adicionar contato à plataforma de automação de e-mail - Atualizar Registro para rastrear participação na sequência - Criar Registro para tarefa de acompanhamento para monitorar o engajamento ### Integração de Pontuação de Leads **Problema**: Você precisa de uma pontuação de leads sofisticada que combine dados do CRM com sinais externos. **Solução**: Envie dados de leads para ferramentas de pontuação externas ou implemente lógica de pontuação em fluxos de trabalho. **Opção 1 - Ferramenta Externa**: **Gatilho**: Registro é Atualizado (objeto Pessoas) **Ações**: - Requisição HTTP para enviar dados de leads para a plataforma de pontuação - Ação de código para processar resposta de pontuação - Atualizar Registro com pontuação de lead - Criar Registro para tarefa de vendas se a pontuação exceder o limite **Opção 2 - Lógica Interna**: **Gatilho**: Registro é Atualizado (objeto Pessoas) **Ações**: - Ação de código com algoritmo de pontuação (tamanho da empresa, indústria, comportamento) - Atualizar Registro com pontuação calculada - Enviar alerta por e-mail para representante de vendas para leads com alta pontuação ### Geração de Faturas **Problema**: Quando os negócios fecham, seu sistema de faturamento precisa ser atualizado com as informações do cliente e do negócio. **Solução**: Envie automaticamente dados do negócio para seu sistema de faturamento quando as oportunidades forem ganhas. **Gatilho**: Registro é Atualizado (objeto Oportunidades, Estágio = "Fechado Ganho") **Ações**: - Pesquisar Registros para obter informações completas dos clientes - Ação de código para formatar dados para o sistema de faturamento - Requisição HTTP para criar cliente na plataforma de faturamento - Requisição HTTP para gerar fatura - Atualizar Registro para armazenar referência da fatura - Enviar Email para a equipe financeira com detalhes da fatura ## Padrões Avançados de Integração ### Sincronização Bidirecional **Problema**: Você precisa manter os dados sincronizados entre o Twenty e outro sistema em ambas as direções. **Solução**: Combine fluxos de trabalho agendados com gatilhos de webhook para sincronização em tempo real. **De Twenty para Sistema Externo**: **Gatilho**: Registro é Atualizado (qualquer objeto relevante) **Ações**: - Requisição HTTP para atualizar sistema externo - Atualizar Registro para rastrear status de sincronização e carimbo de data/hora **De Sistema Externo para Twenty**: **Gatilho**: Webhook (do sistema externo) **Ações**: - Pesquisar Registros para encontrar registro correspondente - Atualizar Registro com novos dados do sistema externo - Criar Registro para tarefa de resolução de conflitos, se necessário ### Processamento de Dados em Múltiplas Etapas **Problema**: Dados de fontes externas precisam de processamento complexo antes de serem usados no Twenty. **Solução**: Use ações de código para transformação e validação de dados. **Gatilho**: Webhook ou Em um Agendamento **Ações**: - Ação de código para validar formato de dados recebidos - Ação de código para transformar estrutura de dados - Ação de código para aplicar regras de negócios e cálculos - Pesquisar Registros para verificar duplicados - Criar ou Atualizar Registro com dados processados - Enviar alerta por e-mail se forem detectados problemas de qualidade de dados ## Dicas de Implementação - Armazene chaves de API com segurança em Configurações → API e Webhooks - Use HTTPS para todas as chamadas de API externas - Fique atento aos limites de taxa de API - use fluxos de trabalho agendados quando possível - Considere atualizações em lote "Em um Agendamento" quando o processamento em tempo real não for necessário - Lembre-se do limite de 100 fluxos de trabalho simultâneos por espaço de trabalho - use disponibilidade "Em Massa" para gatilhos manuais ao processar vários registros (veja [Recursos do Fluxo de Trabalho](/l/pt/user-guide/workflows/workflow-features) para detalhes) - Teste com dados de amostra antes de ativar fluxos de trabalho Para solucionar problemas de integração, veja nosso guia [Solução de Problemas de Fluxo de Trabalho](/l/pt/user-guide/workflows/workflow-troubleshooting). Para ajuda com a implementação de integrações complexas, considere nossos [Serviços Profissionais](/l/pt/user-guide/workflows/professional-services).