Webhook de entrada por fluxos

Esta é uma funcionalidade destinada a usuários com conhecimento técnico avançado, voltada para profissionais de tecnologia. A configuração envolve o uso de outras ferramentas (CRM, formulários, sistemas próprios, etc.) para enviar dados à Ummense.

A Ummense facilita a integração com outras plataformas usando webhooks, que são uma forma simples de comunicação entre diferentes sistemas. Basicamente, um webhook permite que eventos específicos em uma ferramenta enviem dados em tempo real para a Ummense criando cards em fluxos e colunas específicas. Um evento pode ser um novo Lead marcado como ganho em um CRM ou quando o formulário de contato do  seu site é preenchido, por exemplo.

Este artigo mostra como configurar um webhook de entrada, ou seja, como receber dados de outra ferramenta para criar cards na Ummense automaticamente. Se o seu objetivo é o contrário, enviar dados da Ummense para outra ferramenta, configure um webhook de saída.

Antes de começar algumas regras importantes:

• Cada requisição recebida cria um novo card. O webhook de entrada nunca atualiza ou movimenta um card já existente.
• Você pode criar até 5 webhooks de entrada por fluxo. 
• Depois de salvar as configurações do webhook, não é mais possível buscar novas requisições. Se precisar testar de novo, será necessário criar um novo webhook.
• Tags e Campos personalizados devem ser criados previamente. Webhooks não criam novas tags e campos. 

Passo 1: Criar o webhook

Nas configurações do fluxo, acesse a categoria Webhooks e selecione "Adicionar webhook de entrada". Defina:

• Nome da integração (ex: nome do formulário ou CRM, para facilitar a identificação depois)
• Coluna onde os cards serão criados

Em seguida, clique em "Gerar URL de webhook".

Passo 2: Conectar sua ferramenta

A URL gerada é o endereço para onde sua ferramenta deve enviar os dados. Copie essa URL e insira nas configurações de webhook da sua ferramenta ou código.

‍

Passo 3: Testar e visualizar os dados recebidos

Envie uma requisição a partir da sua ferramenta ou código. Depois, na Ummense, clique em "Pesquisar requisições" para conferir se os dados chegaram corretamente.

Você pode reenviar quantas vezes precisar para ajustar os dados. O sistema guarda as 5 requisições mais recentes, ao enviar uma nova, a mais antiga é substituída.

Passo 4 : Atribuir os dados aos campos do card

Com os dados mapeados na Ummense, use a opção "Campos do card" para definir nome, descrição, tags e arquivos. Para cada campo, escolha qual dado recebido deve preenchê-lo.

Para adicionar mais campos, clique em "Adicionar campo" e repita o processo.

Passo 5: Campos personalizados e contatos

Siga o mesmo processo para atribuir dados aos campos personalizados, clique em "Adicionar campo" e selecione a opção "Campos personalizados". Os campos disponíveis são organizados por categoria (Pessoa, Empresa e Card). Saiba mais sobre os campos personalizados e suas categorias em Campos personalizados na Ummense.

Para criar um contato junto com o card, inclua o campo e-mail na integração, ele é o identificador único usado para reconhecer o contato. Para criar contatos do tipo Pessoa, os campos (Nome, E-mail, Celular, CPF) precisam pertencer à categoria Pessoa.

Passo 6 : Salvar

Configurados todos os campos, clique em "Salvar e voltar" ou "Salvar".

Estrutura da requisição

Os dados enviados não podem estar aninhados, como nesse exemplo:

Cada informação precisa estar em sua própria chave, separada:

{
  "nome": "Matheus",
  "objetivo": "Preciso de uma proposta",
  "numero": "47999999999",
  "email": "matheus@teste.com",
  "data_de_contato": "12/06/2026",
  "origem": "Tráfego Pago",
}

Chegando dessa forma na Ummense:

O webhook apenas recebe os dados como eles chegam, ele não reorganiza ou trata a estrutura. Se os dados estiverem aninhados, é preciso ajustá-los na ferramenta de origem antes de enviar.

Tags

Para adicionar mais de uma tag por card, os dados enviados devem estar estruturados em formato de lista (array).

• Se você está usando código direto: basta enviar no formato padrão de array (ex: ["Tag A", "Tag B"]).
• Se você está usando ferramentas de integração(CRMs, formulários): Será necessário conferir se os dados são enviados em modo lista. Se a sua plataforma de origem enviar tudo em uma única linha de texto separada por vírgulas, utilize uma função de divisão (split) ou conversão para array em uma ferramenta de integração antes de enviar os dados para a Ummense.

Arquivos

Para criar cards com arquivos, envie a URL direta do arquivo (ex: https://exemplo.com/documento.pdf). Links do Google Drive e similares não funcionam.

Para conferir se a URL está no formato correto, abra-a em uma nova aba, o arquivo deve começar a baixar automaticamente.

Regras importantes:

• A URL precisa ser pública e válida (acessível sem login ou permissão especial)
• Limite de 100MB por arquivo
• Máximo de 10 arquivos por requisição

Para enviar mais de um arquivo, os dados precisam estar em lista:

‍

‍