> ## 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. # Verificação de identidade com Zapier: automatização > Automatize a verificação de identidade com a app Didit para Zapier. Inicie verificações e receba resultados em 6,000+ apps. Preços por utilização. Ligue o Didit a **6,000+ aplicações** através do Zapier, sem necessidade de código. Crie automaticamente sessões de verificação, reaja às alterações de estado e sincronize os resultados com o seu CRM, base de dados ou ferramentas de comunicação. > [card] [Abrir o Didit no Zapier](https://zapier.com/apps/didit/integrations) > > Consulte os acionadores, as ações e os modelos prontos a usar no marketplace do Zapier. [Integração do Didit com o Zapier](https://www.youtube.com/embed/D7X4kNHxX0A?rel=0\&playsinline=1) *** ## O que obtém > [card] Criar sessões > > Acione sessões de verificação a partir de submissões de formulários, eventos do CRM ou de qualquer aplicação ligada ao Zapier. > [card] Webhooks em tempo real > > Receba atualizações de estado instantâneas (Aprovada, Recusada, Em análise, etc.) como acionadores do Zapier. > [card] Obter resultados > > Obtenha os detalhes completos da sessão, incluindo dados de identificação, pontuações de prova de vida e ocorrências de AML, sempre que precisar. *** ## Pré-requisitos | Requisito | Onde obter | | - | - | | **Conta Didit** | Registe-se em [business.didit.me](https://business.didit.me). O plano KYC gratuito é suficiente para testar. | | **Chave de API** | Consola → **API e Webhooks** → copie a chave de produção. A aplicação do Zapier autentica-se com esta chave em cada ação. | | **ID do fluxo** | Consola → **Fluxos** → escolha o fluxo que pretende iniciar (ou [crie um](https://docs.didit.me/pt/console/workflows.md)). | | **Conta Zapier** | Gratuita ou paga: [zapier.com](https://zapier.com). O plano gratuito permite 100 tarefas por mês, suficiente para pequenos projetos piloto. | *** ## Como funciona **1. Ligar o Didit ao Zapier** No Zapier, procure **Didit** no diretório de aplicações (ou abra diretamente a [página no marketplace](https://zapier.com/apps/didit/integrations)) e ligue a sua conta utilizando a **chave de API** da Consola → **API e Webhooks**. > [!TIP] > > A sua chave de API autentica todas as ações do Didit no Zapier. Só precisa de ligar uma vez: todos os seus Zaps partilham a mesma ligação, e fazer a rotação da chave na Consola invalida a ligação do Zapier até a voltar a ligar. **2. Configurar um acionador** Escolha o que inicia o seu Zap. Pode ser um **acionador do Didit** ou de qualquer outra aplicação: | Origem do acionador | Exemplo | | - | - | | **Webhook do Didit** | O estado da sessão passa para "Aprovada" | | **Google Forms** | Nova submissão de formulário → criar uma sessão de verificação | | **HubSpot** | Novo contacto criado → iniciar KYC | | **Stripe** | Novo cliente → verificar a identidade antes de efetuar o pagamento | | **Typeform** | Formulário de onboarding concluído → iniciar verificação | **3. Adicionar uma ação do Didit** Use uma das ações do Didit disponíveis (os nomes correspondem à [página no marketplace do Zapier](https://zapier.com/apps/didit/integrations)): **Criar sessão de verificação**: envolve `POST /v3/session/` * Indique o **ID do fluxo** de verificação a executar. * Opcionalmente, defina um **URL de retorno** para o redirecionamento após a verificação. * Envie **Dados do fornecedor** (por exemplo, o e-mail do utilizador ou o seu ID interno) para associar a sessão aos seus registos. * A ação devolve o novo `session_id`, o `url` visível para o utilizador e o `status` inicial. Utilize o `url` para encaminhar o utilizador para o fluxo de verificação. **Obter sessão de verificação**: envolve `GET /v3/session/{sessionId}/decision/` * Envie um `session_id` para obter o resultado completo da verificação. * Aceda aos dados de identificação, às pontuações de prova de vida, aos resultados de AML, ao `status` final e a quaisquer URLs de conteúdos multimédia carregados. **4. Reagir aos resultados** Adicione ações posteriores com base no resultado da verificação: | Estado | Ação sugerida | | - | - | | `"Approved"` | Atualizar o CRM, conceder acesso à plataforma, enviar e-mail de boas-vindas | | `"Declined"` | Sinalizar na base de dados, notificar a conformidade, enviar e-mail de recusa | | `"In Review"` | Criar uma tarefa para a equipa de conformidade, enviar notificação no Slack | | `"Abandoned"` | Enviar um lembrete por e-mail com uma nova ligação de verificação | ![Criar uma sessão de verificação de identidade do Didit a partir de um passo 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) Criar uma sessão de verificação do Didit a partir de uma ação do Zapier. *** ## Modelos Zap populares > [card] Google Forms → Didit → Gmail > > O utilizador preenche o formulário de onboarding → é criada a sessão de verificação → o resultado é enviado por e-mail ao utilizador e ao administrador. > [card] HubSpot → Didit → HubSpot > > Novo contacto → iniciar KYC → atualizar as propriedades do contacto com o estado da verificação e os dados de identificação. > [card] Stripe → Didit → Slack > > Novo cliente → verificar a identidade → notificar a sua equipa no Slack com o resultado. > [card] Webhook → Didit → Airtable > > Acionador personalizado → verificar o utilizador → registar os resultados da sessão no Airtable para os registos de conformidade. *** ## Acionadores e ações disponíveis Os nomes abaixo correspondem à aplicação atual do Didit no Zapier, disponível no [marketplace](https://zapier.com/apps/didit/integrations). Se vir uma designação ligeiramente diferente no próprio Zapier, siga a interface do Zapier: o comportamento subjacente é o mesmo. ### Acionadores (iniciam um Zap) | Acionador | Evento subjacente | Descrição | | - | - | - | | **Estado da sessão atualizado** | [webhook `status.updated`](https://docs.didit.me/pt/integration/webhooks) | Dispara sempre que uma sessão de verificação muda de estado (`Approved`, `Declined`, `In Review`, `Resubmitted`, `Abandoned`, `Kyc Expired`, etc.). | ### Ações (executam uma tarefa) | Ação | Endpoint subjacente | Descrição | | - | - | - | | **Criar sessão de verificação** | `POST /v3/session/` | Inicia uma nova sessão com o seu fluxo, um URL de retorno opcional e `vendor_data`. Devolve o URL da sessão a partilhar com o utilizador. | | **Obter sessão de verificação** | `GET /v3/session/{sessionId}/decision/` | Obtém o payload completo da decisão (dados de identificação, prova de vida, ocorrências de AML e estado final) para um determinado `session_id`. | *** ## O que deve saber > [!WARNING] > > A aplicação Didit para Zapier está intencionalmente limitada à **área de automação de maior valor**: iniciar sessões e reagir a atualizações de estado. Os seguintes casos **não estão atualmente disponíveis através do Zapier e exigem uma chamada direta à API**: > > * Carregar uma imagem de documento, um vídeo ou um ativo de comprovativo de morada (POA) a partir de um passo do Zap. > * Substituições de decisão através de [`PATCH /v3/session/{sessionId}/update-status/`](https://docs.didit.me/pt/sessions-api/update-status). > * Endpoints específicos de KYB (registos, pessoas-chave). > * Tipos de eventos de webhook diferentes das alterações de estado ao nível da sessão (por exemplo, `transaction.status.updated`, `user.status.updated`). > > Se precisar de alguma destas funcionalidades a partir de uma ferramenta sem código, recorra à [API de sessões](https://docs.didit.me/pt/sessions-api/create-session.md) através de um passo **Webhooks by Zapier** com a sua chave de API. *** ## Dicas e boas práticas > [accordion] Use os Dados do fornecedor para associar sessões > > Passe sempre um identificador único (e-mail, ID de utilizador ou UUID) no campo **Dados do fornecedor** ao criar sessões. Isto permite-lhe associar os resultados da verificação ao utilizador correto no seu sistema. > [accordion] Trate todos os resultados de estado > > Crie caminhos no Zap (através da funcionalidade Paths do Zapier) para tratar os estados de forma diferente: aprovada, recusada, em análise, reenviada, abandonada e expirada merecem cada uma uma resposta personalizada. > [accordion] Use filtros para reduzir o ruído > > Adicione Filtros do Zapier para acionar ações posteriores apenas para estados específicos. Por exemplo, envie um e-mail de boas-vindas apenas quando o estado for `"Approved"`. > [accordion] Teste antes de passar para produção > > Use a funcionalidade de teste do Zapier juntamente com o botão **Try Webhook** da Didit (em Console → API & Webhooks) para validar o seu Zap de ponta a ponta antes de processar utilizadores reais. *** ## Próximos passos > [card] [Guia de início rápido](https://docs.didit.me/pt/getting-started/quick-start.md) > > Configure a sua conta Didit, crie um fluxo e obtenha a sua chave de API. > [card] [Webhooks](https://docs.didit.me/pt/integration/webhooks.md) > > Saiba mais sobre os payloads dos webhooks e a verificação de assinaturas para integrações do lado do servidor. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.