> ## 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. # Integração da Didit: API, SDK e webhooks > Como integrar a Didit com a API de sessões, SDKs e webhooks e passar do sandbox para a produção. Transcrição do vídeo para desenvolvedores. [Integre a Didit ao seu app: API, SDK e webhooks (guia para desenvolvedores)](https://www.youtube.com/embed/fX03-WEu_EI) Transcrição completa de **Integre a Didit ao seu app: API, SDK e webhooks (guia para desenvolvedores)**, vídeo 8 de 10 da Didit Academy, 08:13. [Assista no YouTube](https://www.youtube.com/watch?v=fX03-WEu_EI). Cada parágrafo leva ao momento exato do vídeo. ## O que você vai conectar [00:04](https://www.youtube.com/watch?v=fX03-WEu_EI\&t=4s) Neste vídeo, você vai conectar a Didit ao seu próprio app. Assim, seus usuários fazem a verificação dentro do seu produto, e cada resultado volta para o seu sistema no momento em que acontece. Este é o vídeo para desenvolvedores, então é um pouco mais técnico, mas é mais simples do que você imagina. E, no final, você vai ver que pode entregar a maior parte direto para o Claude Code e deixar que ele construa tudo para você. Então, vamos seguir a ordem em que ## SDK, API e webhook: as três peças [00:28](https://www.youtube.com/watch?v=fX03-WEu_EI\&t=28s) você realmente faria isso. Vamos lá. Integrar a Didit significa conectar três coisas. O SDK renderiza a câmera, a captura do documento, a leitura por NFC e a interface de prova de vida dentro do seu app. A API é de servidor para servidor, então o seu back-end cria a sessão e lê a decisão oficial. E o webhook chama o seu endpoint HTTPS no instante em que uma sessão muda de estado, o que é muito ## A aba de integração [00:56](https://www.youtube.com/watch?v=fX03-WEu_EI\&t=56s) mais rápido e completo do que fazer polling. Então, a forma mais fácil de integrar é ir até a aba de gerenciamento, clicar em integrar, e podemos pegar todas as configurações aqui mesmo, então podemos pegar a nossa chave de API. Podemos configurar uma chave de API específica para este app em que estamos trabalhando. Podemos criar e escolher o fluxo de verificação (workflow) que queremos integrar. Podemos adicionar um webhook. É para lá que os resultados da verificação são enviados. [01:24](https://www.youtube.com/watch?v=fX03-WEu_EI\&t=84s) E o segredo de assinatura, que vou mostrar em seguida, é o que vai ## Escolhendo sua plataforma [01:28](https://www.youtube.com/watch?v=fX03-WEu_EI\&t=88s) para o seu arquivo ENV. Depois, você pode conectá-lo ao seu app. Temos algumas opções diferentes aqui. Temos Web JS, React Native, iOS, Android, Flutter e algumas outras plataformas. Então, você pode selecionar a que for relevante para o seu app. Estes são os segredos de ambiente que você vai colocar no seu arquivo ENV no seu ## O prompt de configuração com IA [01:48](https://www.youtube.com/watch?v=fX03-WEu_EI\&t=108s) servidor. A forma fácil de configurar isso é usar o prompt de configuração com IA. Configuramos todas as opções aqui em cima e depois copiamos o prompt, que vai copiar todas as informações relevantes de que precisamos da configuração que acabamos de concluir. Copiamos e colamos isso no Cloud Code, no Codex ou onde quer que você esteja ## Chaves de API, uma por ambiente [02:09](https://www.youtube.com/watch?v=fX03-WEu_EI\&t=129s) construindo o seu app. Suas chaves de API ficam aqui, e cada linha tem uma chave, certo? Um bom hábito é ter uma chave separada por ambiente e por integração. Assim, você pode rotacionar ou revogar uma sem interromper as outras. Então, se você vai integrar um fluxo específico, você ## Criando uma chave [02:27](https://www.youtube.com/watch?v=fX03-WEu_EI\&t=147s) você pode querer ter uma chave de API separada só para esse fluxo, por exemplo. Agora, se eu clicar em criar chave de API, hum, vou colocar "test" aqui e criar a chave de API. Agora posso copiá-la, certo? E não vou vê-la de novo. Por isso, é importante copiá-la e talvez anotá-la em algum lugar para poder usá-la quando estiver fazendo a integração. Quando você chega à seção de integração e pega a sua chave de API, digamos que eu pegue a chave "test" e desça a página, eu seleciono, ok, queremos usar este, hã, vamos ver, fluxo de KYC. Podemos adicionar um webhook. [03:05](https://www.youtube.com/watch?v=fX03-WEu_EI\&t=185s) Podemos conectar o nosso app, ok. E depois podemos colar este prompt de configuração aqui. Dá para ver que este prompt vai ## Visão geral dos webhooks [03:13](https://www.youtube.com/watch?v=fX03-WEu_EI\&t=193s) incluir a chave de API. Passando rapidamente para os webhooks, podemos configurar um webhook para basicamente qualquer coisa que quisermos. Digamos que você queira enviar um evento específico para o Slack, certo? Podemos ## A documentação [03:25](https://www.youtube.com/watch?v=fX03-WEu_EI\&t=205s) adicione a URL do webhook aqui. Ok, vamos dar uma olhada em parte da documentação, porque você tem acesso a toda a documentação técnica. É só acessar docs.didit.me, e vamos ver algumas coisas ## Criar sessão: o único campo obrigatório [03:37](https://www.youtube.com/watch?v=fX03-WEu_EI\&t=217s) aqui. Tudo gira em torno da criação de sessão. Certo, esta é uma requisição POST. É o início de uma verificação. Podemos ver aqui, na requisição curl, que temos o ID do fluxo. Este é o único campo obrigatório, e o mais útil é que este mesmo endpoint cria sessões tanto de KYC quanto de KYB. O ## Vendor data e URL de retorno [04:00](https://www.youtube.com/watch?v=fX03-WEu_EI\&t=240s) O fluxo é o que decide qual é qual. Temos alguns campos adicionais aqui embaixo, incluindo o campo vendor data, sobre o qual falamos bastante nestes vídeos. É o identificador único de cada usuário, e você pode defini-lo como quiser, seja um e-mail ou um identificador único, e depois temos a URL de retorno aqui. É para lá que o usuário será enviado depois de concluir o fluxo de verificação. Então, ## Testando o endpoint em tempo real [04:24](https://www.youtube.com/watch?v=fX03-WEu_EI\&t=264s) Se rolarmos a página para baixo, podemos testar isso de verdade. Se clicarmos em "try it", podemos criar uma sessão de verificação aqui mesmo. Vou colar uma das chaves de API aqui. Vou criar uma nova, "test two". Copio a chave. Colo aqui. Precisamos de um ID de fluxo. Então, vamos até aqui. Podemos pegar este ID de fluxo. Colamos ali. O vendor data não é obrigatório. Vamos colocar só uma sequência aleatória de números. [05:02](https://www.youtube.com/watch?v=fX03-WEu_EI\&t=302s) Podemos manter a mesma URL de retorno. Aliás, nada disso é obrigatório. Acho que é porque tenho uma conta de teste aqui, mas, se você quiser testar este endpoint, é exatamente assim que testaria. Agora, se você é desenvolvedor e quer respostas específicas, pode consultar a documentação. O MCP também tem acesso a toda esta documentação, então você pode simplesmente integrar o MCP e fazer ao Claude qualquer pergunta que tiver sobre algo técnico que provavelmente esteja nestes documentos ## Webhooks: por que não usar polling [05:32](https://www.youtube.com/watch?v=fX03-WEu_EI\&t=332s) Então, vamos falar de webhooks. Temos uma aba de webhooks aqui na seção de gerenciamento, e é por ela que os seus resultados realmente chegam até você. Os webhooks são o canal recomendado porque o polling é bem lento, e ele ## Adicionando um destino e escolhendo os eventos [05:44](https://www.youtube.com/watch?v=fX03-WEu_EI\&t=344s) vai custar mais requisições e vai ignorar eventos. Então, adicionamos um novo destino aqui. Podemos colar uma URL. Podemos escolher os eventos que queremos. Ou seja, esses são todos os dados que queremos enviar para esse endpoint específico. E a Didit vai devolver para você um segredo de assinatura de uso único, que eu já vou mostrar. E a URL precisa ser acessível diretamente. Ou seja, nada de localhost e nada de IPs privados. Então, vou sair daqui, e podemos rolar para o lado direito, onde temos algumas opções. [06:16](https://www.youtube.com/watch?v=fX03-WEu_EI\&t=376s) Então, aqui vemos o número de eventos que esse webhook está escutando, e podemos ## O segredo de assinatura [06:19](https://www.youtube.com/watch?v=fX03-WEu_EI\&t=379s) copie o segredo de assinatura, que vai ser importante para a sua integração. Agora, quando fazemos a configuração da integração na aba de integrações, e eu mostrei para você que temos um prompt lá, o segredo de assinatura vai estar ali para o webhook que você selecionou na configuração. Então, ## O prompt do handler de webhook [06:34](https://www.youtube.com/watch?v=fX03-WEu_EI\&t=394s) outra forma de aproveitar a IA: temos um prompt pronto aqui, que encontrei aqui na aba de webhooks. Dá para ver a opção de configurar o nosso handler de webhook com IA. Podemos consultar a documentação e encontrar um prompt de integração aqui. Ele cobre verificação de identidade, entidade e transação. Ele vai construir tudo para você. Ele descreve tudo: o que construir, os cabeçalhos de assinatura para verificação, os tipos de evento de webhook que você acabou de ver quando configuramos um webhook há pouco. Temos o envelope do webhook e muito mais, e também podemos selecionar onde queremos colá-lo, ou seja, qual ferramenta estamos usando. [07:15](https://www.youtube.com/watch?v=fX03-WEu_EI\&t=435s) Então, se você quiser usar esse prompt, esse é o jeito fácil de começar e deixar as suas integrações configuradas. Tudo o que eu mostrei neste vídeo pode ser acessado e consultado dentro da sua ferramenta de IA se você integrar o servidor MCP. Assim, você só precisa explicar o que quer que aconteça em linguagem natural, e o Cloud Code vai ler a documentação e construir a integração para você. Então, você só confere o trabalho, garante que está rodando e ## Recapitulando [07:41](https://www.youtube.com/watch?v=fX03-WEu_EI\&t=461s) funcionando, em vez de programar tudo do zero. Então, essa é a Didit na sua aplicação. O SDK, que os seus usuários veem, a API que o seu back-end chama e o webhook assinado que entrega o veredito sobre o qual você constrói. Confie no webhook, use os dados do fornecedor em todos os lugares e conte com o prompt de configuração, para não precisar montar à mão as partes chatas. Você pode acessar didit.me, criar uma conta gratuita e ter uma verificação rodando em minutos. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.