O que dá e o que não dá pela API
Antes de contratar um desenvolvedor, vale saber o que a API alcança e o que não alcança. A lista abaixo é honesta: o que dá, dá bem; o que não dá, não adianta insistir.
O que dá
| Área | O que o seu sistema pode fazer |
|---|---|
| Contatos | Criar, atualizar, buscar, listar, apagar, aplicar etiqueta, ler e escrever campo personalizado |
| Oportunidades | Criar no pipeline e fase certos, atualizar valor e dono, mudar status (ganho/perdido), listar por pipeline |
| Conversas | Enviar mensagem (WhatsApp, SMS, e-mail) pra um contato, ler o histórico |
| Calendário | Listar calendários, ler horários livres, criar e cancelar compromisso |
| Usuários | Listar a equipe, pra saber quem é quem ao atribuir |
| Eventos pra fora | Receber no seu sistema, por webhook, o que acontece aqui: lead novo, fase mudou, mensagem recebida, compromisso marcado |
| Eventos pra dentro | Mandar dado do seu sistema pra cá e disparar automação com ele |
O que não dá
- Criar ou editar automação. Dá pra listar e dá pra disparar (pelo webhook de entrada), mas não desenhar. Isso é feito na tela.
- Criar pipeline. Só leitura. Crie na tela e leia o id pela API.
- Configurar WhatsApp, modelos de mensagem e e-mail. Só pela tela.
- Painéis e relatórios prontos. Os números você monta no seu lado a partir dos dados brutos.
- Importação em massa num comando. Importar é criar contato por contato (com upsert), respeitando os limites.
A lista completa do que falta está em O que ainda não tem API.
Os três projetos mais comuns
- ERP ou sistema interno → all4sales: cliente que compra no ERP vira contato aqui, com etiqueta e campo preenchidos, e cai numa automação de pós-venda. Veja Sincronizar com ERP ou planilha.
- Site próprio → all4sales: formulário do seu site cria contato e oportunidade direto, sem passar por formulário da plataforma. Veja Criar ou atualizar contato sem duplicar.
- all4sales → BI: oportunidades e conversas vão pro seu dashboard. Veja Puxar dados pro seu BI.
O que seu dev precisa saber antes de começar
- A API é REST com JSON, autenticada por token. Qualquer linguagem serve.
- Tem limite de chamadas: 100 a cada 10 segundos e 200 mil por dia.
- O id de tudo (pipeline, fase, campo, usuário) é descoberto por chamadas de leitura e não muda. Busque uma vez, guarde.
- A referência completa de cada endpoint fica na documentação oficial da plataforma, linkada em Mapa de endpoints por tarefa.
Primeiro passo prático: Criar seu token.