Recebe dados e cria um novo lead na Triaron.
Endpoint
POST https://crm.triaron.com/api/webhooks/receive/{token}
Parâmetros de URL
| Parâmetro | Tipo | Descrição |
|---|
token | string | Token único do webhook (48 caracteres) |
Campos do payload
O sistema reconhece automaticamente variações dos nomes dos campos em português e inglês:
| Campo | Aliases aceitos | Obrigatório |
|---|
| Nome | name, nome, full_name, fullName | Não |
| Email | email, e_mail, emailAddress | Sim |
| Telefone | phone, telefone, celular, whatsapp, phoneNumber | Não |
| Empresa | company, empresa, organization | Não |
| Valor | value, valor, amount | Não |
| Observação | observation, observacao, message, mensagem, notes | Não |
| Origem | source, origem, platform | Não |
O campo email é obrigatório. O lead será rejeitado se não houver um email válido.
Exemplos
curl -X POST https://crm.triaron.com/api/webhooks/receive/SEU_TOKEN \
-H "Content-Type: application/json" \
-d '{
"nome": "João Silva",
"email": "[email protected]",
"telefone": "(11) 99999-9999",
"empresa": "Empresa ABC",
"mensagem": "Interessado no produto"
}'
Respostas
{
"success": true,
"leadId": "clx1234567890abcdef",
"message": "Lead created successfully"
}
{
"error": "Valid email is required"
}
{
"error": "Webhook is disabled"
}
{
"error": "Invalid webhook token"
}
{
"error": "Internal error"
}
Comportamento do lead
Quando um lead é recebido via webhook:
- Validação - O email é validado (campo obrigatório)
- Criação - O lead é criado na etapa inicial do pipeline
- Atribuição - O lead é atribuído ao primeiro administrador/owner da organização
- Origem - Se o campo
source/origem corresponder a uma origem cadastrada, o lead é vinculado a ela
- Notificação - Uma notificação é enviada para os membros da equipe
- Atividade - Um registro de atividade é criado no histórico do lead
