Skip to main content

​
Quando ocorre

Este evento é disparado sempre que um contato é criado na SocialSell — seja pelo painel, por outra integração via API ou automaticamente ao receber uma mensagem de um número desconhecido no WhatsApp ou Messenger.

​
Casos de uso comuns

  • Sincronizar novos leads com seu CRM ou ERP interno
  • Adicionar o contato a uma lista de e-mail marketing
  • Criar um registro no seu sistema de suporte (Zendesk, Intercom, etc.)
  • Disparar um fluxo de boas-vindas em outra ferramenta
  • Notificar a equipe de vendas via Slack ou e-mail

​
Payload completo

{
  "id": "evt_01jx8kz3m4n5p6q7r8s9t0u1v",
  "event": "contact.created",
  "organization_id": "664a1b2c3d4e5f6789012345",
  "created_at": "2026-06-10T15:00:00.000Z",
  "data": {
    "id": "664f1a2b3c4d5e6f78901234",
    "name": "João Silva",
    "email": "joao@empresa.com.br",
    "phone": "+5511999999999",
    "whatsapp_jid": "5511999999999@s.whatsapp.net",
    "instagram_username": null,
    "source": "whatsapp",
    "assigned_to": null,
    "company": null,
    "tags": [],
    "custom_fields": {},
    "notes_count": 0,
    "deals_count": 0,
    "created_at": "2026-06-10T15:00:00.000Z",
    "updated_at": "2026-06-10T15:00:00.000Z"
  }
}

​
Referência de campos

CampoTipoDescrição
data.idstringID do contato na SocialSell
data.namestringNome completo
data.emailstring|nullE-mail
data.phonestring|nullTelefone formatado com DDI
data.whatsapp_jidstring|nullJID do WhatsApp (para envio de mensagens)
data.instagram_usernamestring|nullUsername do Instagram
data.sourcestringOrigem: whatsapp, messenger, instagram, api, manual
data.assigned_toobject|nullMembro responsável {id, name}
data.companyobject|nullEmpresa vinculada {id, name}
data.tagsstring[]Tags no momento da criação
data.custom_fieldsobjectCampos personalizados {chave: valor}

​
Exemplo de handler

app.post('/webhooks/socialsell', express.raw({ type: 'application/json' }), (req, res) => {
  // 1. Validar assinatura (ver Segurança e verificação)
  if (!isValidSignature(req.body, req.headers['x-socialsell-signature'])) {
    return res.status(401).send('Assinatura inválida');
  }

  const { event, data } = JSON.parse(req.body);

  res.status(200).send('OK'); // responde imediatamente

  if (event === 'contact.created') {
    // sincronizar com ERP
    erpClient.createContact({
      externalId: data.id,
      name: data.name,
      email: data.email,
      phone: data.phone,
      source: data.source,
    });
  }
});