Visão geral das integrações e APIs
O SiteUp foi desenhado para conversar com o resto do seu stack. Esta página resume todas as integrações nativas disponíveis e as interfaces programáticas que permitem estender a plataforma. Use-a como mapa para decidir qual caminho seguir antes de mergulhar nos artigos específicos.
Integrações nativas
São integrações já implementadas pelo time SiteUp — você ativa em poucos cliques no painel, sem escrever código.
| Integração | Para que serve | Quando usar |
|---|---|---|
| n8n | Disparar workflows ao acontecer eventos no SiteUp | Automatizar fluxos entre múltiplas ferramentas (CRM externo, Slack, Sheets) |
| Meta CAPI | Enviar conversões pro Facebook/Instagram Ads | Recuperar atribuição de campanhas Meta em cenário pós-iOS 14 |
| Google Offline Conversion | Enviar conversões pro Google Ads | Mensurar ROI real de campanhas Google que fecham via WhatsApp/atendente |
| Google Agenda | Sincronização bidirecional de eventos | Atendentes que agendam reuniões e querem ver tudo num lugar só |
Todas essas integrações usam eventos do funil Kanban como gatilho principal: quando um card muda de coluna ou é fechado como ganho, a SiteUp dispara o evento configurado.
Interfaces programáticas
São pontos de extensão para times técnicos. Permitem construir integrações próprias quando o que está pronto não cobre seu caso.
API REST
Endpoints HTTP completos para todos os recursos da plataforma — conversas, contatos, mensagens, atendentes, cards do Kanban, equipes, caixas de entrada. Autenticação via header api_access_token. Documentação OpenAPI 3.1 publicada em https://siteup.com.br/docs (Scalar), com arquivos llms.txt e collection Postman pra acelerar adoção.
Use quando precisar buscar ou modificar dados programaticamente — sincronizar contatos com seu ERP, criar conversa a partir de um formulário externo, popular o Kanban a partir de outro sistema.
Webhooks
O SiteUp envia POST HTTP pra uma URL sua sempre que um evento ocorre (mensagem nova, conversa criada, card movido, etc.). O payload chega em JSON e suporta autenticação por Bearer Token ou assinatura HMAC.
Use quando precisar reagir em tempo real a algo que acontece no SiteUp — sem ficar fazendo polling.
MCP Server (AI Mode)
O SiteUp expõe um servidor Model Context Protocol compatível com Claude Desktop, Cursor, ChatGPT (modo developer) e qualquer cliente MCP. Ferramentas disponíveis incluem list_conversations, send_message, search_contact, list_kanban_items, entre outras.
Use quando quiser que agentes IA externos operem o SiteUp em linguagem natural — análises ad-hoc, automações experimentais, copilotos internos.
Como escolher o caminho certo
Pergunta rápida pra encontrar o caminho certo:
- Existe integração pronta? Se sim, ative pelo painel e pule a parte de código.
- Preciso reagir a um evento? Webhook customizado ou n8n.
- Preciso buscar/escrever dados? API REST.
- Quero IA externa operando o SiteUp? MCP Server.
- Cenário híbrido? Combine. É comum usar Webhook → n8n → API REST de volta.
Segurança e limites
Todas as interfaces respeitam o escopo da conta:
- Tokens são por atendente. Se o atendente perde acesso, o token deixa de funcionar.
- Rate limiting padrão: 60 requisições por minuto na API REST. Webhooks e MCP herdam o mesmo orçamento.
- TLS 1.2+ obrigatório em todos os endpoints externos chamados pelo SiteUp.
- Logs de auditoria ficam disponíveis pra administradores em Configurações → Auditoria.
Próximos passos
Escolha o artigo da integração que vai usar:
- Conectando n8n ao SiteUp
- Configurando Meta CAPI
- Configurando Google Offline Conversion
- Sincronização bidirecional com Google Agenda
- Webhooks customizados
- Autenticação na API REST
- MCP Server para agentes IA
Se ainda tiver dúvidas sobre qual caminho seguir, abra o chat do Capitão IA e descreva seu caso — ele costuma sugerir a combinação mais econômica.