Integração Zoho SalesIQ com n8n

Ajude-me a construir meu fluxo de trabalho
1

Oi,
Estou construindo um fluxo de perfil de leads para um cliente:
Puxar leads do Zoho CRM
Enriquecer cada lead com o comportamento do site deles do Zoho SalesIQ
Construir um perfil completo de leads por contato
A peça que falta é uma integração com Zoho SalesIQ. Qual é a melhor maneira de conectar à API SalesIQ (datacenter EU) dentro do n8n — existe um nó da comunidade, ou a abordagem recomendada é um nó HTTP Request com OAuth2 customizado? E se HTTP Request for o caminho a seguir, como você configuraria isso corretamente?

4

oi @LNH bom dia!
hoje em dia não tem node para o zoho, o melhor caminho é seguir pelo http request node com uma credencial oauth api customizada. um ponto de atenção, zoho lista https://accounts.zoho.eu como servidor OAuth para Europa.

1 curtida
5

Oi LNH. Posso ajudar com o lado do Zoho SalesIQ como um slice de integração paga e delimitado.

Para isso, eu não começaria adivinhando uma arquitetura inteira. Primeiro, eu verificaria o caminho OAuth/API da UE, construiria uma rota SalesIQ → enriquecimento de perfil de lead no n8n, mapearia o resultado de volta para os campos do Zoho CRM alvo e adicionaria logging de erros mais notas curtas de handoff.

Esse primeiro slice custaria $450-$650 dependendo de quanto da resposta da API do SalesIQ e do mapeamento do CRM já é conhecido. Eu usaria contatos de amostra/screenshots reduzidos primeiro, e só tocaria em credenciais ao vivo depois que o fluxo exato fosse acordado.

Uma pergunta: você já tem o endpoint da API do SalesIQ / resposta de amostra para comportamento do website, ou o primeiro passo é descobrir o endpoint correto e os escopos OAuth?

6

Não, não tem nó para SalesIQ — HTTP Request com uma credencial OAuth2 genérica é o caminho. Duas coisas que costumam confundir as pessoas no datacenter da UE:
O host de autenticação e o host de API são diferentes: o endpoint de token é accounts.zoho.eu, mas suas chamadas reais do SalesIQ vão para o domínio de dados .eu, não .com. Misturá-los é a causa usual de 401s silenciosos. Os escopos são específicos de maiúsculas e minúsculas e de produto. Pegue a string de escopo exata do SalesIQ no console de API da Zoho em vez de adivinhar — um escopo de CRM muito amplo não cobrirá os dados de visitantes do SalesIQ.
Uma vez que o token se renove corretamente, o resto é apenas GET contra os endpoints de rastreamento de visitantes. Teste a chamada bruta no Postman primeiro para saber se é a credencial n8n e não o escopo.

7

Oi @LNH,

Como não existe um nó nativo dedicado para SalesIQ, usar o nó HTTP Request com uma credencial OAuth2 personalizada é a abordagem padrão. Aqui está o detalhamento técnico para colocar sua integração com datacenter EU em funcionamento:

1. Configuração de Credencial OAuth2

Crie uma nova credencial de API OAuth2 no n8n. Os endpoints de autenticação da EU do Zoho são específicos, então configure-os da seguinte forma:

  • Authorization URL: https://accounts.zoho.eu/oauth/v2/auth

  • Access Token URL: https://accounts.zoho.eu/oauth/v2/token

  • Scope: Você precisará de escopos específicos para SalesIQ (por exemplo, ZohoSalesIQ.visitors.READ, ZohoSalesIQ.reports.READ). Verifique o Zoho API Console para garantir que selecionou os corretos.

2. Estratégia de Endpoint de API

Para dados de visitante/comportamento, você não está apenas acessando um único endpoint.

  • Base URL: Certifique-se de que está direcionando para a base de API específica da EU: https://salesiq.zoho.eu/api/v2/

  • Mapeamento: Como você está construindo um perfil de lead, priorize os endpoints /visitors ou /chats. Use o zoho_crm_lead_id (se passado como um parâmetro personalizado no script de rastreamento de visitantes do SalesIQ) para fazer a junção no seu fluxo de trabalho.

3. Fluxo de Execução

  1. Gatilho Zoho CRM: Puxe sua lista de leads.

  2. HTTP Request (GET): Consulte SalesIQ usando o identificador do lead.

  3. Set/Edit Fields: Como as respostas do SalesIQ geralmente são JSON aninhadas, use o nó Set ou Edit Fields para achatar os dados de comportamento em uma estrutura chave-valor que corresponda ao seu objeto de lead no CRM.

  4. Zoho CRM (PATCH/UPDATE): Envie o perfil enriquecido de volta para o CRM.

Antes de construir o fluxo de trabalho completo, use uma coleção do Postman ou um comando curl simples para acessar o endpoint /visitors e verificar se seu token OAuth2 está retornando o payload esperado. Se receber um 403, verifique novamente suas permissões de escopo no Zoho API Console; quase sempre é uma incompatibilidade entre o escopo solicitado e o token gerado.