> ## Documentation Index > Fetch the complete documentation index at: https://docs.didit.me/llms.txt > Use this file to discover all available pages before exploring further. # Automação de verificação de identidade com Zapier > Automatize fluxos de verificação de identidade com o app Didit para Zapier. Inicie verificações e receba resultados em 6,000+ apps. Pague pelo uso. Conecte a Didit a **6,000+ apps** pelo Zapier, sem escrever código. Crie sessões de verificação automaticamente, reaja a mudanças de status e sincronize os resultados com seu CRM, banco de dados ou ferramentas de comunicação. > [card] [Abrir a Didit no Zapier](https://zapier.com/apps/didit/integrations) > > Explore gatilhos, ações e modelos prontos no marketplace do Zapier. [Integração da Didit com o Zapier](https://www.youtube.com/embed/D7X4kNHxX0A?rel=0\&playsinline=1) *** ## O que você obtém > [card] Criar sessões > > Inicie sessões de verificação a partir de envios de formulários, eventos do CRM ou qualquer app conectado ao Zapier. > [card] Webhooks em tempo real > > Receba atualizações de status instantâneas (Aprovado, Recusado, Em revisão etc.) como gatilhos do Zapier. > [card] Obter resultados > > Consulte sob demanda os detalhes completos da sessão: dados do documento de identidade, pontuações de prova de vida e ocorrências AML. *** ## Pré-requisitos | Requisito | Onde obter | | - | - | | **Conta Didit** | Cadastre-se em [business.didit.me](https://business.didit.me). O plano gratuito de KYC é suficiente para testar. | | **Chave de API** | Console → **API & Webhooks** → copie a chave de produção. O app do Zapier se autentica com essa chave em todas as ações. | | **ID do fluxo de trabalho** | Console → **Workflows** → escolha o workflow que você quer iniciar (ou [crie um](https://docs.didit.me/pt-br/console/workflows.md)). | | **Conta Zapier** | Gratuita ou paga: [zapier.com](https://zapier.com). O plano gratuito comporta 100 tarefas/mês, o suficiente para pilotos pequenos. | *** ## Como funciona **1. Conecte a Didit ao Zapier** No Zapier, pesquise **Didit** no diretório de apps (ou abra diretamente a [página no marketplace](https://zapier.com/apps/didit/integrations)) e conecte sua conta usando a **API Key** disponível em Console → **API & Webhooks**. > [!TIP] > > Sua chave de API autentica todas as ações da Didit no Zapier. Você só precisa se conectar uma vez: todos os seus Zaps compartilham a mesma conexão, e girar a chave no Console invalida a conexão com o Zapier até que você se conecte novamente. **2. Configure um gatilho** Escolha o que inicia o seu Zap. Pode ser um **gatilho da Didit** ou qualquer outro app: | Origem do gatilho | Exemplo | | - | - | | **Webhook da Didit** | O status da sessão muda para "Approved" | | **Google Forms** | Novo envio de formulário → criar uma sessão de verificação | | **HubSpot** | Novo contato criado → iniciar o KYC | | **Stripe** | Novo cliente → verificar a identidade antes do repasse | | **Typeform** | Formulário de onboarding concluído → iniciar a verificação | **3. Adicione uma ação da Didit** Use uma das ações disponíveis da Didit (os nomes correspondem aos da [página no marketplace do Zapier](https://zapier.com/apps/didit/integrations)): **Create Verification Session**: encapsula `POST /v3/session/` * Informe o **ID do fluxo de trabalho** do fluxo de verificação a ser executado. * Opcionalmente, defina uma **URL de retorno** para o redirecionamento após a verificação. * Envie **Dados do fornecedor** (por exemplo, o e-mail do usuário ou seu ID interno) para vincular a sessão aos seus registros. * A ação retorna o novo `session_id`, a `url` exibida ao usuário e o `status` inicial. Use a `url` para direcionar o usuário ao fluxo de verificação. **Retrieve Verification Session**: encapsula `GET /v3/session/{sessionId}/decision/` * Envie um `session_id` para obter o resultado completo da verificação. * Acesse os dados do documento de identidade, as pontuações de prova de vida, os resultados AML, o `status` final e as URLs de quaisquer mídias enviadas. **4. Reaja aos resultados** Adicione ações subsequentes com base no resultado da verificação: | Status | Ação sugerida | | - | - | | `"Approved"` | Atualizar o CRM, liberar o acesso à plataforma, enviar e-mail de boas-vindas | | `"Declined"` | Sinalizar no banco de dados, notificar a equipe de conformidade, enviar e-mail de recusa | | `"In Review"` | Criar uma tarefa para a equipe de conformidade, enviar notificação no Slack | | `"Abandoned"` | Enviar e-mail de lembrete com um novo link de verificação | ![Criação de uma sessão de verificação de identidade da Didit a partir de uma etapa de ação do Zapier](https://mintcdn.com/didit-0f962782/DSfxHq_ggIpqiQSG/images/zapier-create-session.png?fit=max\&auto=format\&n=DSfxHq_ggIpqiQSG\&q=85\&s=f847a30aa1e0b600543ae4dec6229cdd) Criação de uma sessão de verificação da Didit a partir de uma ação do Zapier. *** ## Modelos populares de Zap > [card] Google Forms → Didit → Gmail > > O usuário preenche o formulário de onboarding → a sessão de verificação é criada → o resultado é enviado por e-mail ao usuário e ao administrador. > [card] HubSpot → Didit → HubSpot > > Novo contato → iniciar o KYC → atualizar as propriedades do contato com o status da verificação e os dados de identificação. > [card] Stripe → Didit → Slack > > Novo cliente → verificar a identidade → notificar sua equipe no Slack com o resultado. > [card] Webhook → Didit → Airtable > > Gatilho personalizado → verificar o usuário → registrar os resultados da sessão no Airtable para os registros de conformidade. *** ## Gatilhos e ações disponíveis Os nomes abaixo correspondem ao app atual da Didit no [marketplace](https://zapier.com/apps/didit/integrations) do Zapier. Se você encontrar um rótulo um pouco diferente dentro do próprio Zapier, confie na interface do Zapier: o comportamento subjacente é o mesmo. ### Gatilhos (iniciam um Zap) | Gatilho | Evento correspondente | Descrição | | - | - | - | | **Session Status Updated** | [Webhook `status.updated`](https://docs.didit.me/pt-br/integration/webhooks) | É disparado sempre que uma sessão de verificação muda de status (`Approved`, `Declined`, `In Review`, `Resubmitted`, `Abandoned`, `Kyc Expired` etc.). | ### Ações (executam algo) | Ação | Endpoint correspondente | Descrição | | - | - | - | | **Create Verification Session** | `POST /v3/session/` | Inicia uma nova sessão com seu fluxo, a URL de retorno opcional e `vendor_data`. Retorna a URL da sessão para compartilhar com o usuário. | | **Retrieve Verification Session** | `GET /v3/session/{sessionId}/decision/` | Obtém o payload completo da decisão (dados do documento de identidade, prova de vida, ocorrências AML e status final) para um determinado `session_id`. | *** ## O que saber > [!WARNING] > > O app da Didit para o Zapier tem um escopo intencionalmente limitado aos **recursos de automação mais valiosos**: iniciar sessões e reagir a atualizações de status. Os itens a seguir **não** estão disponíveis no Zapier no momento e exigem uma chamada direta à API: > > * Envio de imagem de documento, vídeo ou arquivo de comprovante de endereço a partir de uma etapa do Zap. > * Substituições de decisão via [`PATCH /v3/session/{sessionId}/update-status/`](https://docs.didit.me/pt-br/sessions-api/update-status). > * Endpoints específicos de KYB (registros, pessoas-chave). > * Tipos de evento de webhook diferentes das alterações de status da sessão (por exemplo, `transaction.status.updated`, `user.status.updated`). > > Se você precisar de algum desses recursos em uma ferramenta no-code, use diretamente a [API de sessões](https://docs.didit.me/pt-br/sessions-api/create-session.md) por meio de uma etapa **Webhooks by Zapier** com a sua chave de API. *** ## Dicas e boas práticas > [accordion] Use Vendor Data para vincular sessões > > Sempre envie um identificador único (e-mail, ID de usuário ou UUID) no campo **Vendor Data** ao criar sessões. Assim, você consegue associar os resultados da verificação ao usuário correto no seu sistema. > [accordion] Trate todos os status > > Crie caminhos no Zap (com o recurso Paths do Zapier) para tratar cada status de forma diferente: Aprovado, Recusado, Em revisão, Reenviado, Abandonado e Expirado merecem, cada um, uma resposta específica. > [accordion] Use filtros para reduzir ruído > > Adicione filtros do Zapier para acionar as ações seguintes apenas em status específicos. Por exemplo, envie um e-mail de boas-vindas somente quando o status for `"Approved"`. > [accordion] Teste antes de entrar em produção > > Use o recurso de teste do Zapier junto com o botão **Try Webhook** da Didit (em Console → API & Webhooks) para validar o seu Zap de ponta a ponta antes de processar usuários reais. *** ## Próximos passos > [card] [Guia de início rápido](https://docs.didit.me/pt-br/getting-started/quick-start.md) > > Configure sua conta Didit, crie um workflow e obtenha sua chave de API. > [card] [Webhooks](https://docs.didit.me/pt-br/integration/webhooks.md) > > Saiba mais sobre payloads de webhook e verificação de assinatura para integrações no servidor. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.