O que faz #
Cria um lead com origem "api". Recusa se já existir lead com o mesmo WhatsApp (DDI + número) ou o mesmo e-mail.
Requisição #
| Método | POST |
| URL | https://api.viashopmoda.com.br/via/leads/cadastrar/{TOKEN} |
| Corpo | Objeto JSON { ... }, cabeçalho Content-Type: application/json |
| Token | Substitua {TOKEN} pelo token da loja. Ele vai no caminho da URL, não em cabeçalho. |
Campos #
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
nome | texto | sim | Nome do contato. |
email | texto | sim | E-mail. |
whatsapp_ddi | texto | sim | DDI, ex.: 55. |
whatsapp_numero | texto | sim | Número com DDD, ex.: 35988880101. |
utm_source | texto | não | Origem da campanha. |
utm_medium | texto | não | Mídia. |
utm_campaign | texto | não | Campanha. |
Exemplo #
Pela API, os quatro primeiros campos são obrigatórios (leads criados pela própria loja podem ter só e-mail ou só WhatsApp).
{
"nome": "Joana",
"email": "joana@exemplo.com.br",
"whatsapp_ddi": "55",
"whatsapp_numero": "35988880101",
"utm_source": "instagram",
"utm_medium": "stories",
"utm_campaign": "inverno"
}Sucesso: {"retorno": true, "msg": "Lead cadastrado com sucesso.", "id": "..."}. Duplicado: Lead já existe.
Pode reenviar? #
Sim: o reenvio é recusado com "Lead já existe".