> ## 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 Didit: API, SDK e Webhooks > Transcrição do vídeo: o percurso de integração para programadores na Didit - API de sessão, SDKs, webhooks e passagem do sandbox para produção. [Integre a Didit na sua aplicação: API, SDK e Webhooks (Guia do programador)](https://www.youtube.com/embed/fX03-WEu_EI) Transcrição completa de **Integre a Didit na sua aplicação: API, SDK e Webhooks (Guia do programador)** - Vídeo 8 de 10 da Didit Academy, 08:13. [Ver no YouTube](https://www.youtube.com/watch?v=fX03-WEu_EI). Cada parágrafo tem uma ligação para o momento exato do vídeo. ## O que vai integrar [00:04](https://www.youtube.com/watch?v=fX03-WEu_EI\&t=4s) Neste vídeo, vai ligar a Didit à sua própria aplicação. Assim, os seus utilizadores verificam a identidade diretamente dentro do seu produto, e cada resultado chega ao seu sistema no momento em que acontece. Este é o vídeo para programadores, por isso é um pouco mais técnico, mas é mais simples do que parece. E no final vai ver que pode entregar grande parte disto diretamente ao Cloud Code e pedir-lhe que o construa por si. Por isso, vamos percorrer tudo na 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) o construiria de facto. Vamos já a isso. Integrar a Didit significa ligar três coisas. O SDK apresenta a câmara, a captura do documento, a leitura NFC e a interface de prova de vida diretamente dentro da sua aplicação. A API é de servidor para servidor, por isso 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 ## O separador de integração [00:56](https://www.youtube.com/watch?v=fX03-WEu_EI\&t=56s) mais rápido e fornece mais informações do que fazer polling. Por isso, a forma mais fácil de integrar é ir ao seu separador Manage, clicar em Integrate e obter aqui todas as definições, por isso pode obter a sua chave de API. Assim, pode criar uma chave de API específica para esta aplicação em que estamos a trabalhar. Pode criar e escolher um fluxo que queira integrar. Pode adicionar um webhook. É para aqui que os resultados das verificações são enviados. [01:24](https://www.youtube.com/watch?v=fX03-WEu_EI\&t=84s) E o segredo de assinatura, que lhe mostro já a seguir, é o que vai ## Escolher a sua plataforma [01:28](https://www.youtube.com/watch?v=fX03-WEu_EI\&t=88s) ir para o seu ficheiro ENV. Depois pode ligá-lo à sua aplicação. Temos várias opções: Web JS, React Native, iOS, Android, Flutter e algumas outras plataformas. Por isso, pode selecionar a que for relevante para a sua aplicação. Estes são os segredos de ambiente que vai colocar no ficheiro ENV do seu ## O prompt de configuração com IA [01:48](https://www.youtube.com/watch?v=fX03-WEu_EI\&t=108s) servidor. A forma mais fácil de configurar isto é usar o prompt de configuração com IA. Por isso, configuramos todas as definições aqui em cima, depois copiamos o prompt, e ele copia todas as informações relevantes de que precisamos da configuração que acabou de fazer aqui. Copiamos e colamos isto e podemos colá-lo no Cloud Code, no Codex ou onde estiver a ## Chaves de API, uma por ambiente [02:09](https://www.youtube.com/watch?v=fX03-WEu_EI\&t=129s) criar a sua aplicação. As suas chaves de API estão aqui, e cada linha tem uma chave, certo? Por isso, uma boa prática é ter uma chave separada por ambiente e por integração. Assim, pode fazer a rotação ou revogar uma sem afetar as outras. Por isso, se for integrar um fluxo específico, você ## Criar uma chave [02:27](https://www.youtube.com/watch?v=fX03-WEu_EI\&t=147s) pode querer ter simplesmente uma chave de API separada para esse fluxo, por exemplo. Agora, se clicar em create API key, hum, vou só pôr aqui test e criar a chave de API. Agora, posso copiá-la, certo? E não a vou voltar a ver. Por isso, é importante que a copie e talvez a anote algures, para a poder usar quando fizer a integração. Quando chegar à secção de integração e obtiver a sua chave de API, e vamos supor que pego na chave de teste, desço e seleciono, certo, queremos usar este, hum, deixe-me ver, fluxo KYC. Podemos adicionar um webhook. [03:05](https://www.youtube.com/watch?v=fX03-WEu_EI\&t=185s) Podemos ligar a nossa aplicação, certo. E depois podemos colar aqui este prompt de configuração. Pode ver aqui 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. Assim, passando rapidamente aos webhooks, podemos configurar um webhook para praticamente tudo o que quisermos. Por exemplo, se quiser 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) adicionar aqui o URL do webhook. Certo, então vamos ver um pouco da documentação, porque tem acesso a toda a documentação técnica. Basta ir a 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 da sessão. Certo, isto é um pedido POST. É o início de uma verificação. Aqui, no pedido curl, vemos o ID do fluxo. Este é o único campo obrigatório, e o aspeto realmente útil é que este mesmo endpoint cria sessões de KYC e de KYB. O ## Dados do fornecedor e URL de retorno [04:00](https://www.youtube.com/watch?v=fX03-WEu_EI\&t=240s) fluxo é o que decide qual é qual. Temos ainda alguns campos adicionais aqui em baixo, incluindo o vendor data, de que já falámos muito nestes vídeos. É o identificador único de cada utilizador, e pode defini-lo como quiser, seja um e-mail ou um identificador único, e depois temos aqui o URL de retorno. É para onde o utilizador é enviado depois de concluir o fluxo de verificação. Por isso, ## Experimentar o endpoint em direto [04:24](https://www.youtube.com/watch?v=fX03-WEu_EI\&t=264s) se descermos aqui, podemos experimentá-lo mesmo. Assim, se clicarmos em try it, podemos criar aqui uma sessão de verificação. Vou só colar aqui uma das chaves de API. Vou criar uma nova, test two. Vou copiá-la. Colo-a aqui. Queremos obter um ID de fluxo. Por isso, vou ali. Podemos obter este ID de fluxo aqui. Introduzo-o ali. Os dados do fornecedor não são obrigatórios. Vamos só pôr uma sequência aleatória de números. [05:02](https://www.youtube.com/watch?v=fX03-WEu_EI\&t=302s) O URL de retorno pode manter-se igual aqui. Nada disto é obrigatório, de resto. Acho que é porque tenho aqui uma conta de teste, mas se quisesse testar este endpoint, seria exatamente assim que o testaria. Agora, se for programador e quiser respostas específicas, pode consultar a documentação. O MCP também tem acesso a toda esta documentação, por isso pode simplesmente integrar o MCP e fazer ao Claude uma pergunta sobre algo técnico, que provavelmente estará nestes documentos ## Webhooks: porque não usar polling [05:32](https://www.youtube.com/watch?v=fX03-WEu_EI\&t=332s) aqui dentro. Assim, vamos falar de webhooks. Temos aqui, na secção de gestão, um separador para webhooks, e é assim que os resultados chegam efetivamente até si. Os webhooks são o canal recomendado, porque o polling é bastante lento, e é ## Adicionar um destino e escolher os eventos [05:44](https://www.youtube.com/watch?v=fX03-WEu_EI\&t=344s) vai custar-lhe mais pedidos e vai perder eventos. Assim, adicionamos aqui um novo destino. Podemos colar um URL. Podemos escolher os eventos que queremos. Ou seja, estes são todos os dados que queremos enviar para este endpoint específico. E a Didit vai devolver-lhe um segredo de assinatura de utilização única, que lhe mostro daqui a pouco. E o URL tem de ser diretamente acessível. Portanto, nada de localhost nem de IPs privados. Vou sair daqui e podemos deslocar-nos para o lado direito, onde temos algumas opções. [06:16](https://www.youtube.com/watch?v=fX03-WEu_EI\&t=376s) Aqui vemos o número de eventos que este webhook está a ouvir, e podemos ## O segredo de assinatura [06:19](https://www.youtube.com/watch?v=fX03-WEu_EI\&t=379s) copiar o segredo de assinatura, que vai ser importante para a sua integração. Agora, quando fazemos a configuração da integração no separador de integrações, e já lhe mostrei isso, temos um prompt, e o segredo de assinatura vai estar aqui, para o webhook que selecionou na configuração. Portanto, ## O prompt para o manipulador do webhook [06:34](https://www.youtube.com/watch?v=fX03-WEu_EI\&t=394s) mais uma das formas como pode tirar partido da IA: temos aqui um prompt pré-feito que encontrei no separador de webhooks. Podemos ver se quer configurar o seu handler de webhooks com IA. Podemos consultar a documentação e encontrar aqui um prompt de integração. Isto vai abranger a verificação de identidade, a entidade e a transação. Vai construir tudo para si. Portanto, mostra tudo: o que construir, os cabeçalhos de verificação da assinatura, os tipos de evento de webhook que acabou de ver quando configurámos um webhook há pouco. Temos o envelope do webhook e muitas outras coisas, e também podemos escolher onde o queremos colar, qual a ferramenta que estamos a usar. [07:15](https://www.youtube.com/watch?v=fX03-WEu_EI\&t=435s) Portanto, se quiser usar este prompt, é a forma mais simples de começar e de ter as integrações configuradas. Tudo o que acabei de percorrer neste vídeo está acessível e pode ser consultado na sua ferramenta de IA se integrar o servidor MCP. Assim, basta explicar em linguagem simples o que quer que aconteça, e o Cloud Code vai ler a documentação e construir a integração por si. Por isso, só tem de verificar o resultado, confirmar que está a correr ## Resumo [07:41](https://www.youtube.com/watch?v=fX03-WEu_EI\&t=461s) e a funcionar, em vez de programar tudo do zero. É isto a Didit na sua app: o SDK, que os seus utilizadores veem, a API que o seu back-end chama, e o webhook assinado que entrega o veredicto em que assenta. Confie no webhook, use os dados do fornecedor em todo o lado, e recorra ao prompt de configuração, para não ter de ligar à mão as partes repetitivas. Pode ir a didit.me, registar-se gratuitamente e executar uma verificação em minutos. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.