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

# Integração Instantly

> Envie contatos verificados do Enrow para as suas campanhas e listas de leads do Instantly

## Visão geral

A integração com o Instantly permite enviar contatos das suas listas do Enrow diretamente para uma **campanha ou lista de leads** do Instantly, com e-mails, números de telefone e dados de personalização verificados, mapeados para variáveis personalizadas. Sem exportações de CSV, sem reverificação.

<Info>
  Os e-mails encontrados pelo Enrow **já estão verificados**, então reverificá-los na importação só serviria para gastar os seus créditos de verificação do Instantly.
</Info>

## Configuração

<Steps>
  <Step title="Obter sua chave de API do Instantly">
    No [Instantly](https://app.instantly.ai/app/settings/integrations), acesse **Settings → Integrations → API Keys** e crie uma nova chave (API v2). Copie-a imediatamente, pois ela só é exibida uma vez.

    O acesso à API está incluído em **todos os planos do Instantly**. Recomendamos criar a chave com o escopo `all:all`; no mínimo, ela precisa de `campaigns:read`, `lead_lists:read` e `leads:create`.
  </Step>

  <Step title="Conectar o Instantly no Enrow">
    No [Dashboard do Enrow](https://app.enrow.io), acesse **Integrations** no menu à esquerda, clique em **Instantly** e cole sua chave de API. O Enrow valida a chave com o Instantly antes de salvá-la.

    <Info>
      Em uma conta de equipe, apenas os **administradores da equipe** conectam a integração. Todos os membros da equipe podem então enviar contatos por meio da conexão compartilhada.
    </Info>
  </Step>

  <Step title="Configurar (opcional)">
    O envio funciona imediatamente com um mapeamento padrão adequado. Na página da integração, você também pode definir:

    * **Destino padrão**: a campanha ou lista de leads para onde seus envios vão por padrão
    * **Mapeamento de campos**: quais campos do Enrow alimentam quais campos e variáveis personalizadas do Instantly
    * **Opções de envio**: como a deduplicação e a verificação na importação se comportam
  </Step>
</Steps>

## Enviando contatos

A partir de qualquer lista do Enrow, envie um único contato (linha do contato → ícone do Instantly) ou selecione várias linhas e use a ação **Push** em massa. Escolha o destino (campanhas e listas de leads são compatíveis) e confirme.

* O seletor de destino exibe um selo verde **“Already pushed”** em cada campanha ou lista de leads para a qual o contato já foi enviado (com a data; para envios em massa, uma contagem `pushed/selected`). Um destino que já contém todos os contatos selecionados fica esmaecido, mas continua selecionável: reenviar é uma operação inofensiva e sem efeito graças à própria deduplicação do Instantly.
* Os contatos **precisam ter um e-mail**, então qualquer linha sem um e-mail encontrado é ignorada e reportada.
* Após cada envio, você recebe as contagens de contatos adicionados, duplicados e ignorados, e cada envio aparece na aba **History** da integração. Se a cota de upload de leads do seu plano do Instantly for atingida, o Enrow avisa você.
* As campanhas gerenciadas pelo recurso **AI SDR** do Instantly ficam ocultas no seletor, exatamente como o Instantly as oculta na sua própria lista de campanhas.

<Info>
  Por padrão, o Instantly ignora um lead que já existe **em qualquer lugar do seu workspace** (mesmo em outra campanha). Se você quiser usar o mesmo contato em várias campanhas, desative “Skip leads already in your workspace” nas opções de envio da integração.
</Info>

## Mapeamento de campos

Mapeamento padrão (editável na página da integração):

| Campo do Enrow  | Campo do Instantly                      |
| --------------- | --------------------------------------- |
| E-mail          | `email`                                 |
| Nome            | `first_name`                            |
| Sobrenome       | `last_name`                             |
| Nome da empresa | `company_name`                          |
| Telefone        | `phone`                                 |
| URL do LinkedIn | `linkedin_url` (variável personalizada) |
| Título          | `headline` (variável personalizada)     |
| Localização     | `location` (variável personalizada)     |

As variáveis personalizadas são criadas automaticamente em cada lead quando você faz o envio, sem nada para configurar no Instantly. Use-as nas suas sequências como `{{linkedin_url}}`, `{{headline}}` etc. (os nomes das variáveis diferenciam maiúsculas de minúsculas).

## Opções de envio

| Opção                                | Padrão      | Efeito                                                                                                                                                                       |
| ------------------------------------ | ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Skip leads already in your workspace | **Ativado** | Ignora contatos que já existem em qualquer lugar do seu workspace do Instantly, então a mesma pessoa nunca é contatada duas vezes                                            |
| Skip leads already in a campaign     | Desativado  | Ignora contatos que já estão em outra campanha                                                                                                                               |
| Verify leads on import               | Desativado  | Executa a própria verificação do Instantly nos leads enviados (não é necessário para e-mails encontrados pelo Enrow, e consome os seus créditos de verificação do Instantly) |

## Precisa de ajuda?

* **Suporte Enrow**: [api@enrow.io](mailto:api@enrow.io)
