---
url: https://developers.zarv.com/integrations.md
description: >-
  Integrações do SmartFlow com sistemas externos: o que são, o catálogo (Locavia
  e Cotalk (Helena)) e como cada campanha envia seus leads.
---

# Integrações

Uma integração liga uma **campanha** do SmartFlow a um sistema externo. O
SmartFlow emite um evento a cada etapa do cadastro e a integração reage a
ele: cria o cliente, atualiza o contato. Você configura
tudo no admin Zarv.

::: tip Campanha, fluxo e funil
O admin chama a campanha de "fluxo" ou "funil". Estas páginas usam
**campanha**.
:::

## Catálogo

Para ligar qualquer uma delas, siga [Conectar e ativar uma integração](/integrations/connect-and-activate).

## Como funciona

1. O visitante avança na campanha e o SmartFlow emite um evento por etapa
   (`lead.basic.completed`, `lead.email.completed` e assim por diante) e,
   no fim, o evento terminal (`lead.approved`, `lead.rejected`,
   `lead.completed`).
2. Cada par (evento, lead) vira um envio. A integração reage aos eventos de
   que precisa: a Locavia roda em `lead.approved`; a Cotalk (Helena) roda em
   todos os 11 eventos.
3. O resultado aparece no sistema externo.
4. Se um envio falha, ele é tentado de novo a partir do ponto em que parou.
   As regras de entrega do webhook da sua campanha estão em
   [Webhook da campanha](/sdk/webhooks); elas se aplicam ao seu endpoint, não
   a estes envios.

Os eventos são os mesmos do webhook. A lista completa está em
[Webhook da campanha](/sdk/webhooks).

### Uma conexão por campanha

Locavia e Cotalk (Helena) são configuradas **por campanha**. Cada campanha
tem a sua própria conexão, com a sua própria credencial. Duas campanhas que
usam a mesma conta externa guardam uma credencial cada, e uma campanha sem
conexão nunca usa a conta de outra.

### Dois níveis de liga/desliga

As duas precisam estar ligadas. Com a **Integração ativa** desligada, o
painel da campanha fica travado.

### Quem faz o quê

* **Administrador do workspace:** liga a **Integração ativa** e altera a
  conta, a credencial e a conexão.
* **Quem edita a campanha:** mantém as configurações da própria campanha.

### Quando algo falha

O que você vê depende da integração. Na Locavia, a **Visão geral** mostra o
**Resumo de envios** (com a contagem de **Com falha**), a aba **Status**
lista os envios da campanha, e um e-mail de falha é enviado quando um envio
esgota as tentativas. Na Cotalk (Helena), os erros aparecem ao salvar, e uma
etiqueta ou campo apagado no CRM interrompe aquela parte e é citado no erro
do envio. Os detalhes estão em cada página.