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

# Integrações

> Ligue formulários, CRMs, ferramentas de analytics e plataformas de CMS à Finseo.

# Integrações

A Finseo liga-se ao seu CMS, às suas ferramentas de analytics, ao seu stack de reporting e ao seu CRM para que possa otimizar conteúdo, medir o tráfego referido por IA e comprovar o impacto na receita. Todos os connectors abaixo estão disponíveis no seu dashboard em **Settings → Integrations**.

## Todos os connectors

### CMS & conteúdo

<CardGroup cols={2}>
  <Card title="Shopify" icon="https://www.google.com/s2/favicons?domain=shopify.com&sz=128" href="https://app.finseo.ai/integrations">
    Otimize títulos SEO de produtos, descrições e dados estruturados a partir do agente.
  </Card>

  <Card title="WordPress" icon="https://www.google.com/s2/favicons?domain=wordpress.org&sz=128" href="https://app.finseo.ai/integrations">
    Edite posts, páginas e meta tags do Yoast/RankMath através da WordPress REST API.
  </Card>

  <Card title="Webflow" icon="https://www.google.com/s2/favicons?domain=webflow.com&sz=128" href="https://app.finseo.ai/integrations">
    Atualize itens do CMS, definições de SEO das páginas e injete dados estruturados JSON-LD.
  </Card>

  <Card title="Framer" icon="https://www.google.com/s2/favicons?domain=framer.com&sz=128" href="https://app.finseo.ai/integrations">
    Edite entradas do CMS, injete schemas no head e publique o seu site.
  </Card>
</CardGroup>

### Analytics

<CardGroup cols={2}>
  <Card title="Google Analytics" icon="https://www.google.com/s2/favicons?domain=analytics.google.com&sz=128" href="/pt/human-traffic">
    Acompanhe o tráfego referido por IA, conversões e receita do GA4.
  </Card>

  <Card title="Google Search Console" icon="https://www.google.com/s2/favicons?domain=search.google.com&sz=128" href="/pt/search-console">
    Pesquisas, páginas, CTR e posições a par da visibilidade em IA.
  </Card>

  <Card title="Bing Webmaster Tools" icon="https://www.google.com/s2/favicons?domain=bing.com&sz=128" href="/pt/search-console">
    Monitorize o desempenho do Bing para o tráfego de IA impulsionado pelo Copilot.
  </Card>
</CardGroup>

### Reporting & dados

<CardGroup cols={2}>
  <Card title="Looker Studio" icon="https://www.google.com/s2/favicons?domain=datastudio.google.com&sz=128" href="/pt/looker-studio">
    Crie dashboards para clientes e relatórios white-label com o community connector.
  </Card>

  <Card title="Finseo MCP" icon="https://www.google.com/s2/favicons?domain=finseo.ai&sz=128" href="/pt/mcp/overview">
    Use os seus dados de visibilidade no Claude, ChatGPT e Cursor através do Model Context Protocol.
  </Card>

  <Card title="Finseo API" icon="https://www.google.com/s2/favicons?domain=finseo.ai&sz=128" href="/pt">
    Acesso REST programático a todas as métricas do dashboard para o seu próprio stack.
  </Card>
</CardGroup>

### Attribution & CRM

Envie a resposta a "Como é que nos encontrou?" para a Finseo sempre que é criado um lead, submissão de formulário, marcação, encomenda ou negócio.

<CardGroup cols={3}>
  <Card title="HubSpot" icon="https://www.google.com/s2/favicons?domain=hubspot.com&sz=128" href="#hubspot" />

  <Card title="Salesforce" icon="https://www.google.com/s2/favicons?domain=salesforce.com&sz=128" href="#salesforce" />

  <Card title="Typeform" icon="https://www.google.com/s2/favicons?domain=typeform.com&sz=128" href="#typeform-e-jotform" />

  <Card title="Jotform" icon="https://www.google.com/s2/favicons?domain=jotform.com&sz=128" href="#typeform-e-jotform" />

  <Card title="Gravity Forms" icon="https://www.google.com/s2/favicons?domain=gravityforms.com&sz=128" href="#fontes-de-atribuição-suportadas" />

  <Card title="Formstack" icon="https://www.google.com/s2/favicons?domain=formstack.com&sz=128" href="#fontes-de-atribuição-suportadas" />

  <Card title="Attio" icon="https://www.google.com/s2/favicons?domain=attio.com&sz=128" href="#fontes-de-atribuição-suportadas" />

  <Card title="Pipedrive" icon="https://www.google.com/s2/favicons?domain=pipedrive.com&sz=128" href="#fontes-de-atribuição-suportadas" />

  <Card title="Close" icon="https://www.google.com/s2/favicons?domain=close.com&sz=128" href="#fontes-de-atribuição-suportadas" />

  <Card title="Calendly" icon="https://www.google.com/s2/favicons?domain=calendly.com&sz=128" href="#fontes-de-atribuição-suportadas" />

  <Card title="Intercom" icon="https://www.google.com/s2/favicons?domain=intercom.com&sz=128" href="#fontes-de-atribuição-suportadas" />

  <Card title="Zapier / Make / n8n" icon="https://www.google.com/s2/favicons?domain=zapier.com&sz=128" href="#zapier-make-e-n8n" />
</CardGroup>

## Integrações de Attribution

As integrações de Attribution usam:

* Um URL de webhook do projeto para formulários e CRMs.
* A Customer API para ferramentas de automação como Zapier, Make ou n8n.

Os URLs de webhook têm este aspeto:

```text theme={"system"}
https://app.finseo.ai/api/attribution/webhook/PROJECT_ID?source=SOURCE&token=WEBHOOK_TOKEN
```

O parâmetro `source` ajuda a Finseo a escolher o parser certo. O `token` protege o endpoint.

## Fontes de atribuição suportadas

| Fonte               | Caminho recomendado   | Notas                                                                                                                                     |
| ------------------- | --------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| HubSpot             | Webhook de workflow   | Requer uma ação de workflow do HubSpot que envie um webhook. Para ações de webhook nativas pode ser necessário o Data Hub Pro/Enterprise. |
| Salesforce          | Flow HTTP Callout     | Use JSON do Flow Builder. As Outbound Messages nativas do Salesforce enviam XML e não são suportadas.                                     |
| Typeform            | Webhook nativo        | Adicione uma pergunta "Como é que nos encontrou?" e envie todas as respostas para a Finseo.                                               |
| Jotform             | Webhook nativo        | A Finseo processa payloads multipart/form-data e `rawRequest` do Jotform.                                                                 |
| Gravity Forms       | Webhooks Add-On       | Envie JSON e mapeie o campo de atribuição, se necessário.                                                                                 |
| Formstack           | Webhook nativo        | Envie as submissões de formulário como JSON.                                                                                              |
| Attio               | Webhook nativo        | Envie payloads de criação/atualização de registos com campos personalizados.                                                              |
| Pipedrive           | Webhook de automação  | Envie campos de negócio e de pessoa a partir de automações.                                                                               |
| Close               | Webhook nativo        | Envie eventos de lead ou de contacto.                                                                                                     |
| Calendly            | Subscrição de webhook | Envie as respostas dos convidados das perguntas de marcação.                                                                              |
| Intercom            | Webhook nativo        | Envie eventos de contacto ou de conversa com atributos personalizados.                                                                    |
| Zapier / Make / n8n | Pedido HTTP           | Use a API da Finseo ou um webhook genérico e mapeie os campos manualmente.                                                                |

## HubSpot

1. Na Finseo, abra **Integrations** e selecione **HubSpot**.
2. Copie o URL do webhook.
3. No HubSpot, vá a **Automations -> Workflows**.
4. Crie um workflow acionado por uma submissão de formulário ou criação de contacto.
5. Adicione uma ação **Send webhook**.
6. Cole o URL do webhook da Finseo.
7. Submeta um lead de teste e verifique **Attribution** na Finseo.

A Finseo procura campos comuns como `email`, `firstname`, `lastname`, `how_did_you_find_us`, `deal_amount` e `amount`.

## Salesforce

Use **Flow HTTP Callout**, não as Outbound Messages nativas.

```json theme={"system"}
{
  "LeadSource": "ChatGPT",
  "Email": "buyer@example.com",
  "Name": "Alex Buyer",
  "Id": "00Qxx0000012345",
  "Amount": 8500,
  "CurrencyIsoCode": "USD"
}
```

A Finseo mapeia `LeadSource` para o canal de atribuição, `Email` para o email do respondente, `Name` para o nome do respondente, `Amount` para o valor do negócio e `CurrencyIsoCode` para a moeda.

## Typeform e Jotform

Nas ferramentas de formulários, adicione uma pergunta como:

```text theme={"system"}
How did you find us?
```

Boas opções de resposta:

* ChatGPT
* Perplexity
* Claude
* Google
* Redes sociais
* Amigo ou colega
* Anúncios
* Outro

Depois adicione o URL do webhook da Finseo nas definições de webhook do formulário. A Finseo recebe a submissão completa e extrai a resposta de atribuição.

## Zapier, Make e n8n

Use estes quando a sua ferramenta de origem não tem webhook nativo ou quando quer transformar campos antes de os enviar para a Finseo.

```json theme={"system"}
{
  "channelId": "{{how_did_you_find_us}}",
  "respondentEmail": "{{email}}",
  "respondentName": "{{name}}",
  "respondentExternalId": "{{crm_id}}",
  "dealValue": "{{amount}}",
  "dealCurrency": "{{currency}}",
  "metadata": {
    "source_tool": "zapier",
    "form": "{{form_name}}"
  }
}
```

Pode enviar isto para o URL de webhook do projeto ou para a [Create Attribution API](/api-reference/attribution/submit).

## Mapeamento de campos

Se uma ferramenta enviar campos com nomes invulgares, envie primeiro um payload de teste. A Finseo cria um workflow de Attribution a partir da estrutura recebida. Abra **Attribution -> Workflows** e mapeie os campos para:

* Resposta de atribuição
* Email
* Nome
* Valor do negócio
* Moeda do negócio
* ID do formulário

Use regras quando um campo de origem precisa de tradução. Por exemplo, mapeie `utm_source contains chatgpt` para `AI Search`.

## Checklist de testes

* Envie uma submissão de teste a partir da ferramenta de origem.
* Confirme que a resposta aparece em **Attribution**.
* Confirme que a categoria do canal está correta, especialmente para fontes de IA.
* Adicione `dealValue` e `dealCurrency` se quiser reporting de receita.
* Adicione um `respondentExternalId` estável, como o ID da encomenda, ID do lead ou ID do negócio.
* Mantenha os nomes dos campos consistentes entre mercados e países.