Ctrlk
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Criando webhooks

Visão geral

Webhooks no Connect permitem que você receba notificações em tempo real quando eventos específicos ocorrerem em sua conta. Você pode criar e configurar webhooks pelo portal Trust.

Acessando o gerenciamento de webhooks

  1. Faça login no portal Trust:

    • Acesse o portal Trust e autentique-se com suas credenciais.

  2. Acesse as Configurações de API:

    • No painel, localize o menu de navegação.

    • Clique em Configurações (ícone de engrenagem) no menu.

    • Selecione Configurações de API no menu.

Configurações de API

  1. Acessar a seção de Webhooks:

    • Na página de configurações de API , clique na aba Webhooks .

    • Esta página exibe todos os seus webhooks existentes com seus status, URLs de payload e ações disponíveis.

Lista de Webhooks

Criando um novo webhook

Para criar um novo webhook, siga estas etapas:

  1. Iniciar a criação do webhook:

    • Clique no botão "+ Novo webhook" no cabeçalho da página.

  2. Configurar as configurações do webhook:

    • Um Novo webhook modal será exibido, onde você pode configurar as definições do seu webhook.

Modal de Novo Webhook

Configuração básica

URL do payload: Informe a URL para a qual a Certta deve enviar eventos de webhook. Isso deve ser um endpoint HTTPS válido que possa receber solicitações POST.

Segredo: Forneça uma chave secreta que será usada para gerar a assinatura do webhook. Isso permite verificar se as solicitações realmente vieram da Certta.

Configuração de autenticação

Escolha o método de autenticação para o endpoint do seu webhook:

Nenhuma

Nenhuma autenticação será usada ao enviar solicitações de webhook.

Autenticação básica

Configuração de Autenticação Básica

Forneça credenciais de nome de usuário e senha que serão incluídas nas solicitações de webhook usando Autenticação Básica HTTP.

Autenticação por chave de API

Configuração da Chave de API

Configure a autenticação por chave de API especificando:

  • Cabeçalho: O nome do cabeçalho (por exemplo, X-API-Key)

  • Valor: O valor da chave de API

Seleção de eventos

Escolha quais eventos devem acionar seu webhook:

Enviar tudo

Esta opção enviará todos os eventos disponíveis para o endpoint do seu webhook.

Deixe-me selecionar eventos individuais

Seleção de eventos

Quando você selecionar esta opção, poderá escolher eventos específicos na lista disponível. A interface exibirá todos os eventos atualmente compatíveis, incluindo Eventos de Comunicação, Eventos de Transação e Eventos de Autenticação.

Os eventos mostrados na interface são apenas para fins ilustrativos. A lista real de eventos pode ser diferente, pois novos eventos podem ser adicionados ou eventos existentes podem ser modificados ao longo do tempo. Consulte sempre a interface atual para obter a lista mais atualizada dos eventos disponíveis.

Para obter informações detalhadas sobre cada tipo de evento, sua estrutura e exemplos de payload, consulte a documentação de Eventos.

Ativação

Marque a caixa de seleção "Ativo" para habilitar o webhook imediatamente após a criação. Você sempre pode ativar ou desativar webhooks depois na interface de gerenciamento.

Concluindo a criação do webhook

Após configurar todas as definições:

  1. Revise a configuração do seu webhook

  2. Clique em "Criar webhook" para concluir a configuração

  3. Seu novo webhook aparecerá na lista de webhooks e começará a receber eventos com base na sua configuração

Próximos passos

Após criar seu webhook:

Atualizado