Skip to main content

​
Antes de começar

Você precisa ter uma conta ativa na Triaron
Acesso ao painel de administração

​
Passo a passo

1

Acesse o painel de webhooks

Na Triaron, navegue até Configurações → Webhooks no menu lateral.
Você encontra as configurações clicando no ícone de engrenagem no canto inferior esquerdo.
2

Crie um novo webhook

Clique em Criar webhook e preencha:
CampoExemploDescrição
NomeLanding Page PrincipalIdentificador para você lembrar a origem
StatusAtivoHabilita o recebimento de leads
Ao salvar, um token único de 48 caracteres será gerado automaticamente.
3

Copie sua URL

Sua URL de webhook terá este formato:
https://crm.triaron.com/api/webhooks/receive/{seu_token_aqui}
Guarde este token em segurança. Qualquer pessoa com acesso pode enviar dados para sua organização.
4

Teste sua integração

Envie uma requisição de teste para verificar se tudo está funcionando:
curl -X POST https://crm.triaron.com/api/webhooks/receive/SEU_TOKEN \
  -H "Content-Type: application/json" \
  -d '{
    "nome": "Lead de Teste",
    "email": "[email protected]",
    "telefone": "(11) 99999-9999"
  }'
5

Verifique o lead

Se tudo estiver correto, você verá esta resposta:
{
  "success": true,
  "leadId": "clx1234567890abcdef",
  "message": "Lead created successfully"
}
O lead aparecerá automaticamente no seu pipeline, na primeira etapa do funil.

​
Integrando com formulários HTML

A forma mais simples de capturar leads é usando um formulário HTML: 
<form action="https://crm.triaron.com/api/webhooks/receive/SEU_TOKEN" method="POST">
  <input type="text" name="nome" placeholder="Seu nome" required />
  <input type="email" name="email" placeholder="Seu email" required />
  <input type="tel" name="telefone" placeholder="Seu telefone" />
  <textarea name="mensagem" placeholder="Como podemos ajudar?"></textarea>
  <button type="submit">Enviar</button>
</form>
O formulário pode usar application/x-www-form-urlencoded (padrão do HTML) ou application/json. Ambos funcionam.

​
Campos disponíveis

O sistema aceita variações dos nomes dos campos em português e inglês:
CampoVariações aceitas
Nomenome, name, full_name, fullName
Emailemail, e_mail, emailAddress
Telefonetelefone, phone, celular, whatsapp
Empresaempresa, company, organization
Valorvalor, value, amount
Mensagemmensagem, message, observacao, notes
Origemorigem, source, platform
Apenas o email é obrigatório. Todos os outros campos são opcionais.

​
Troubleshooting

O campo email é obrigatório e deve ser um email válido. Verifique se você está enviando o campo corretamente.
O webhook está desabilitado. Acesse Configurações → Webhooks e ative-o.
O token está incorreto ou o webhook foi excluído. Verifique se copiou o token completo.
  1. Verifique se a resposta foi success: true
  2. Atualize a página do pipeline
  3. Verifique se o lead não foi para outra etapa

​
Próximos passos

Todos os campos

Veja a documentação completa do endpoint de criação de leads

Verificar webhook

Endpoint para testar se o webhook está ativo

Autenticação

Entenda como funciona a segurança dos tokens

Boas práticas

Dicas de segurança para proteger sua integração