# SocialSell API

## Docs

- [Criar agente de IA](https://docs.socialsell.ai/api-reference/ai-agents/create.md): Cria um novo agente de IA em status de rascunho.
- [Excluir agente de IA](https://docs.socialsell.ai/api-reference/ai-agents/delete.md): Remove permanentemente um agente de IA.
- [Duplicar agente](https://docs.socialsell.ai/api-reference/ai-agents/duplicate.md): Cria uma cópia de um agente existente em status de rascunho.
- [Buscar agente de IA](https://docs.socialsell.ai/api-reference/ai-agents/get.md): Retorna os dados completos de um agente de IA pelo ID.
- [Kill Switch global](https://docs.socialsell.ai/api-reference/ai-agents/kill-switch.md): Pausa ou restaura todos os agentes de IA da organização de uma vez.
- [Listar agentes de IA](https://docs.socialsell.ai/api-reference/ai-agents/list.md): Retorna todos os agentes de IA da organização.
- [Pausar agente](https://docs.socialsell.ai/api-reference/ai-agents/pause.md): Pausa um agente de IA ativo, interrompendo novas execuções.
- [Publicar agente](https://docs.socialsell.ai/api-reference/ai-agents/publish.md): Ativa um agente de IA em rascunho, colocando-o em produção.
- [Retomar agente](https://docs.socialsell.ai/api-reference/ai-agents/resume.md): Reativa um agente de IA pausado.
- [Registrar feedback](https://docs.socialsell.ai/api-reference/ai-agents/runs-feedback.md): Envia avaliação humana sobre a qualidade de uma execução de agente.
- [Buscar execução](https://docs.socialsell.ai/api-reference/ai-agents/runs-get.md): Retorna os dados completos de uma execução de agente pelo ID.
- [Listar execuções](https://docs.socialsell.ai/api-reference/ai-agents/runs-list.md): Lista execuções (runs) de agentes de IA com filtros e paginação.
- [Estatísticas de agentes](https://docs.socialsell.ai/api-reference/ai-agents/stats.md): Métricas agregadas de execuções, handoffs, tokens e custo por período.
- [Atualizar agente de IA](https://docs.socialsell.ai/api-reference/ai-agents/update.md): Atualiza configurações de um agente de IA existente.
- [Autenticação](https://docs.socialsell.ai/api-reference/authentication.md): Como autenticar suas requisições à API SocialSell com API Keys.
- [Cancelar disparo](https://docs.socialsell.ai/api-reference/broadcasts/cancel.md): Cancela definitivamente um disparo em andamento ou pausado.
- [Criar disparo](https://docs.socialsell.ai/api-reference/broadcasts/create.md): Cria um novo disparo em massa em status de rascunho.
- [Excluir disparo](https://docs.socialsell.ai/api-reference/broadcasts/delete.md): Remove permanentemente um disparo em rascunho ou cancelado.
- [Duplicar disparo](https://docs.socialsell.ai/api-reference/broadcasts/duplicate.md): Cria uma cópia de um disparo existente em status de rascunho.
- [Estimar audiência](https://docs.socialsell.ai/api-reference/broadcasts/estimate.md): Calcula quantos contatos serão atingidos por uma configuração de audiência.
- [Buscar disparo](https://docs.socialsell.ai/api-reference/broadcasts/get.md): Retorna os dados completos de um disparo pelo ID.
- [KPIs de disparos](https://docs.socialsell.ai/api-reference/broadcasts/kpis.md): Métricas agregadas de todos os disparos dos últimos 30 dias.
- [Lançar disparo](https://docs.socialsell.ai/api-reference/broadcasts/launch.md): Inicia o envio de um disparo em rascunho ou agendado.
- [Listar disparos](https://docs.socialsell.ai/api-reference/broadcasts/list.md): Retorna todos os disparos em massa da organização.
- [Mensagens do disparo](https://docs.socialsell.ai/api-reference/broadcasts/messages.md): Lista as mensagens individuais enviadas em um disparo, com status por contato.
- [Pausar disparo](https://docs.socialsell.ai/api-reference/broadcasts/pause.md): Pausa um disparo em andamento, interrompendo os envios.
- [Retomar disparo](https://docs.socialsell.ai/api-reference/broadcasts/resume.md): Retoma um disparo pausado, continuando os envios pendentes.
- [Configurar envio](https://docs.socialsell.ai/api-reference/broadcasts/send-config.md): Ajusta o perfil de velocidade de envio e agendamento de um disparo.
- [Atualizar disparo](https://docs.socialsell.ai/api-reference/broadcasts/update.md): Atualiza nome, descrição ou configurações de um disparo em rascunho.
- [Criar empresa](https://docs.socialsell.ai/api-reference/companies/create.md): Cria uma nova empresa na organização.
- [Excluir empresa](https://docs.socialsell.ai/api-reference/companies/delete.md): Remove uma empresa da organização.
- [Buscar empresa](https://docs.socialsell.ai/api-reference/companies/get.md): Retorna os dados completos de uma empresa, incluindo contatos e negócios vinculados.
- [Listar empresas](https://docs.socialsell.ai/api-reference/companies/list.md): Retorna uma lista paginada de empresas da organização.
- [Tags de empresa](https://docs.socialsell.ai/api-reference/companies/tags.md): Adicione e remova tags de uma empresa.
- [Atualizar empresa](https://docs.socialsell.ai/api-reference/companies/update.md): Atualiza campos de uma empresa existente.
- [Criar contato](https://docs.socialsell.ai/api-reference/contacts/create.md): Cria um novo contato na organização.
- [Excluir contato](https://docs.socialsell.ai/api-reference/contacts/delete.md): Remove um contato da organização (soft delete).
- [Buscar contato](https://docs.socialsell.ai/api-reference/contacts/get.md): Retorna os dados completos de um contato, incluindo negócios vinculados.
- [Listar contatos](https://docs.socialsell.ai/api-reference/contacts/list.md): Retorna uma lista paginada de contatos da organização.
- [Notas de contato](https://docs.socialsell.ai/api-reference/contacts/notes.md): Crie, liste, atualize e exclua notas em um contato.
- [Tags de contato](https://docs.socialsell.ai/api-reference/contacts/tags.md): Adicione e remova tags de um contato sem sobrescrever as existentes.
- [Atualizar contato](https://docs.socialsell.ai/api-reference/contacts/update.md): Atualiza campos de um contato existente.
- [Buscar conversa](https://docs.socialsell.ai/api-reference/conversations/get.md): Retorna os dados de uma conversa específica.
- [Listar conversas](https://docs.socialsell.ai/api-reference/conversations/list.md): Retorna uma lista paginada de conversas do inbox multi-canal.
- [Mensagens da conversa](https://docs.socialsell.ai/api-reference/conversations/messages.md): Lista as mensagens de uma conversa com suporte a paginação.
- [Atualizar conversa](https://docs.socialsell.ai/api-reference/conversations/update.md): Atualiza o responsável ou status de uma conversa.
- [Criar campo personalizado](https://docs.socialsell.ai/api-reference/custom-fields/create.md): Cria um novo campo personalizado para contatos, empresas ou negócios.
- [Listar campos personalizados](https://docs.socialsell.ai/api-reference/custom-fields/list.md): Retorna todos os campos personalizados da organização.
- [Atualizar campo personalizado](https://docs.socialsell.ai/api-reference/custom-fields/update.md): Atualiza rótulo, opções, valor padrão ou status de um campo personalizado.
- [Criar negócio](https://docs.socialsell.ai/api-reference/deals/create.md): Cria um novo negócio em um funil de venda.
- [Excluir negócio](https://docs.socialsell.ai/api-reference/deals/delete.md): Remove permanentemente um negócio.
- [Buscar negócio](https://docs.socialsell.ai/api-reference/deals/get.md): Retorna os dados completos de um negócio, incluindo tarefas vinculadas.
- [Listar negócios](https://docs.socialsell.ai/api-reference/deals/list.md): Retorna uma lista paginada de negócios da organização.
- [Marcar como perdido](https://docs.socialsell.ai/api-reference/deals/lost.md): Marca um negócio como perdido (status: lost).
- [Mover negócio](https://docs.socialsell.ai/api-reference/deals/move.md): Move um negócio para outra etapa (e opcionalmente outro funil de venda).
- [Notas de negócio](https://docs.socialsell.ai/api-reference/deals/notes.md): Adicione notas a um negócio.
- [Reabrir negócio](https://docs.socialsell.ai/api-reference/deals/reopen.md): Reabre um negócio que estava ganho ou perdido.
- [Tags de negócio](https://docs.socialsell.ai/api-reference/deals/tags.md): Adicione e remova tags de um negócio.
- [Atualizar negócio](https://docs.socialsell.ai/api-reference/deals/update.md): Atualiza campos de um negócio existente.
- [Marcar como ganho](https://docs.socialsell.ai/api-reference/deals/won.md): Marca um negócio como ganho (status: won).
- [Erros](https://docs.socialsell.ai/api-reference/errors.md): Formato padrão de erros e referência de todos os códigos de erro da API.
- [Idempotência](https://docs.socialsell.ai/api-reference/idempotency.md): Como usar Idempotency Keys para evitar duplicatas em requisições POST.
- [Contas Instagram](https://docs.socialsell.ai/api-reference/lookup/instagram-accounts.md): Lista as contas do Instagram conectadas à organização.
- [Listar membros](https://docs.socialsell.ai/api-reference/lookup/members.md): Retorna todos os membros ativos da organização.
- [Páginas Messenger](https://docs.socialsell.ai/api-reference/lookup/messenger-pages.md): Lista as páginas do Facebook Messenger conectadas à organização.
- [Listar tags](https://docs.socialsell.ai/api-reference/lookup/tags.md): Retorna todas as tags usadas na organização com contagem de uso.
- [Instâncias WhatsApp](https://docs.socialsell.ai/api-reference/lookup/whatsapp-instances.md): Lista as instâncias WhatsApp conectadas à organização.
- [Recarga automática](https://docs.socialsell.ai/api-reference/message-credits/auto-topup.md): Configura ou desativa a recarga automática de créditos de mensagem.
- [Extrato de créditos](https://docs.socialsell.ai/api-reference/message-credits/ledger.md): Lista o histórico de débitos e créditos da carteira de mensagens.
- [Comprar créditos](https://docs.socialsell.ai/api-reference/message-credits/purchase.md): Inicia uma compra de créditos de mensagem via PIX, boleto ou cartão.
- [Saldo da carteira](https://docs.socialsell.ai/api-reference/message-credits/wallet.md): Consulta o saldo atual de créditos de mensagem da organização.
- [Enviar mensagem](https://docs.socialsell.ai/api-reference/messages/send.md): Envia uma mensagem para um contato via WhatsApp ou Messenger.
- [Paginação](https://docs.socialsell.ai/api-reference/pagination.md): Como navegar por listas grandes usando paginação por cursor.
- [Criar funil de venda](https://docs.socialsell.ai/api-reference/pipelines/create.md): Cria um novo funil de venda com etapas.
- [Excluir funil de venda](https://docs.socialsell.ai/api-reference/pipelines/delete.md): Remove um funil de venda da organização.
- [Buscar funil de venda](https://docs.socialsell.ai/api-reference/pipelines/get.md): Retorna os dados completos de um funil de venda.
- [Listar funis de venda](https://docs.socialsell.ai/api-reference/pipelines/list.md): Retorna todos os funis de venda da organização com suas etapas.
- [Atualizar funil de venda](https://docs.socialsell.ai/api-reference/pipelines/update.md): Atualiza nome, descrição, etapas ou configurações de um funil de venda.
- [Início Rápido](https://docs.socialsell.ai/api-reference/quickstart.md): Faça sua primeira requisição à API SocialSell em menos de 5 minutos.
- [Limites de requisição](https://docs.socialsell.ai/api-reference/rate-limits.md): Limites de requisição por plano e como tratá-los.
- [Permissões](https://docs.socialsell.ai/api-reference/scopes.md): Referência completa de todos os escopos disponíveis para API Keys.
- [Completar tarefa](https://docs.socialsell.ai/api-reference/tasks/complete.md): Marca uma tarefa como concluída.
- [Criar tarefa](https://docs.socialsell.ai/api-reference/tasks/create.md): Cria uma nova tarefa na organização.
- [Excluir tarefa](https://docs.socialsell.ai/api-reference/tasks/delete.md): Remove permanentemente uma tarefa.
- [Buscar tarefa](https://docs.socialsell.ai/api-reference/tasks/get.md): Retorna os dados de uma tarefa específica.
- [Listar tarefas](https://docs.socialsell.ai/api-reference/tasks/list.md): Retorna uma lista paginada de tarefas da organização.
- [Atualizar tarefa](https://docs.socialsell.ai/api-reference/tasks/update.md): Atualiza campos de uma tarefa existente.
- [Criar webhook](https://docs.socialsell.ai/api-reference/webhooks/create.md): Cria uma nova assinatura de webhook para receber eventos da SocialSell.
- [Excluir webhook](https://docs.socialsell.ai/api-reference/webhooks/delete.md): Remove uma assinatura de webhook.
- [Buscar webhook](https://docs.socialsell.ai/api-reference/webhooks/get.md): Retorna os dados de uma assinatura de webhook.
- [Listar webhooks](https://docs.socialsell.ai/api-reference/webhooks/list.md): Retorna todas as assinaturas de webhook da organização.
- [Atualizar webhook](https://docs.socialsell.ai/api-reference/webhooks/update.md): Atualiza nome, URL, eventos ou status de uma assinatura.
- [Bem-vindo à API SocialSell](https://docs.socialsell.ai/index.md): API pública v1 — integre CRM, conversas, disparos e automações da SocialSell com qualquer sistema externo.
- [Política de entregas](https://docs.socialsell.ai/webhooks/delivery.md): Como a SocialSell entrega eventos, lida com falhas e gerencia retentativas.
- [contact.created](https://docs.socialsell.ai/webhooks/events/contact-created.md): Disparado quando um novo contato é criado na organização.
- [contact.updated](https://docs.socialsell.ai/webhooks/events/contact-updated.md): Disparado quando os dados de um contato existente são modificados.
- [deal.created](https://docs.socialsell.ai/webhooks/events/deal-created.md): Disparado quando um novo negócio é criado em qualquer funil de venda.
- [deal.lost](https://docs.socialsell.ai/webhooks/events/deal-lost.md): Disparado quando um negócio é marcado como perdido.
- [deal.stage.changed](https://docs.socialsell.ai/webhooks/events/deal-stage-changed.md): Disparado quando um negócio é movido de uma etapa para outra no funil.
- [deal.won](https://docs.socialsell.ai/webhooks/events/deal-won.md): Disparado quando um negócio é marcado como ganho.
- [message.received](https://docs.socialsell.ai/webhooks/events/message-received.md): Disparado quando uma mensagem é recebida de um contato via WhatsApp, Messenger ou Instagram.
- [Introdução aos Webhooks](https://docs.socialsell.ai/webhooks/introduction.md): Receba notificações automáticas da SocialSell sempre que algo importante acontecer no seu CRM.
- [Segurança e verificação](https://docs.socialsell.ai/webhooks/security.md): Como validar a assinatura HMAC de cada entrega para garantir que veio da SocialSell.

## OpenAPI Specs

- [openapi](https://docs.socialsell.ai/api-reference/openapi.json)

## Optional

- [App](https://socialsell.ai/login)
- [Status](https://status.socialsell.ai)
- [Suporte](https://wa.me/551431480242)