Ir para o conteúdo
SocialSell — início

Sua operação tem
outros sistemas.
Dê continuidade aos dados.

Use a API do SocialSell para trabalhar com cadastros e vendas. Receba eventos por webhooks e conecte o relacionamento com o cliente ao restante da operação.

Abrir documentação

POST /v1/contacts

curl -X POST https://api.socialsell.ai/v1/contacts \
  -H "Authorization: Bearer $SOCIALSELL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: contato-exemplo-001" \
  -d '{
  "name": "Mariana Costa",
  "email": "[email protected]",
  "external_id": "contato-exemplo-001"
}'

Escopo: write:contacts

Veja a estrutura de uma resposta sem enviar uma requisição real.

Dados fictícios. A simulação é local. Para integrar, crie uma chave com os escopos necessários e mantenha-a no seu servidor.

Comece pelo recurso.
Conecte o processo.

Cadastros

/v1/contacts

Contatos e empresas para aproximar os registros dos seus sistemas.

Vendas

/v1/deals

Negócios, pipelines e tarefas para acompanhar o processo comercial.

Atendimento

/v1/conversations

Conversas e recursos de mensagens, conforme o contrato público e os escopos.

Aconteceu aqui.
Seu sistema fica sabendo.

Um negócio foi ganho. Um contato foi criado. Uma etapa mudou. Assine os eventos relevantes e receba as notificações no seu receptor.

Valide a assinatura HMAC-SHA256, confira o timestamp e trate eventos repetidos. O histórico de entregas ajuda a acompanhar tentativas e falhas.

X-Webhook-Signature

HMAC-SHA256(segredo, timestamp.corpo)

O evento acontece no SocialSell

deal.won

POST /seu-receptor

Seu sistema recebe a notificação

Corpo do evento + timestamp + assinatura.

Exemplo local de notificação; nenhuma URL será chamada.

Pronto para integrar
com responsabilidade.

Chaves e escopos

Cada chave pertence a uma organização. Conceda apenas as operações necessárias.

Paginação por cursor

Percorra a base em lotes e continue pelo cursor da resposta.

Idempotência

Use a chave de idempotência nas operações suportadas para tratar repetições.

Limites explícitos

Trate respostas de rate limit e respeite as cotas da chave e do plano.

O contrato vem antes da primeira chamada.

Use uma chave vinculada à organização no header Authorization: Bearer. Os escopos da chave delimitam as operações. Proteja a chave no servidor da integração.

Seu próximo passo tem documentação.

Endpoints, escopos e guias para tirar a integração do desenho e colocar em prática.

Explorar documentação Ver integrações