Criar novo Webhook pela aplicação web

Você pode criar novos Webhooks utilizando a aplicação Web do Asaas, para isso acesse Menu do usuário > Integrações > Webhooks.

---

Ao clicar em "Criar Webhook" um formulário para mais informações irá aparecer. Na primeira etapa você precisa:

• Definir um nome;
• Definir a URL que receberá as informações dos eventos;
• Cadastrar um e-mail que será notificado em caso de erros de comunicação;
• Qual é a versão da API;
• Definir um token de autenticação: este token será enviado no header asaas-access-token em todas as chamadas do Asaas para sua aplicação. Você pode inserir um token próprio ou clicar no botão "Gerar token" para que o Asaas crie um valor seguro para você.
• Se a fila de sincronização está ativada;
• Se o Webhook está ativado;
• Qual o tipo de envio: confira o artigo sobre os tipos de envio disponíveis.

🚧

Token de autenticação seguro

O token deve seguir requisitos mínimos de segurança. Um token seguro deve ter:

• Entre 32 e 255 caracteres;
• Nenhum espaço em branco;
• Ausência de sequências numéricas (ex: 12345) ou 4 letras repetidas;
• Não pode ser uma chave de API Asaas.

Para simplificar sua integração, adicionamos o botão "Gerar token", onde o campo é preenchido com um token que segue todos os requisitos.

Em sequência à configuração, você precisará selecionar os eventos que deseja receber. Você pode conferir a lista completa de eventos na nossa documentação, basta selecionar os eventos que quiser receber em diversos produtos diferentes.

---

Você poderá ter até 10 Webhooks configurados por conta sem restrições de endereços. Você também pode editar ou excluir Webhooks criados.