Integracoes & API

Visão geral das integrações e APIs

Panorama completo das integrações nativas do SiteUp (n8n, Meta CAPI, Google Offline Conversion, Google Agenda) e das interfaces programáticas (API REST, Webhooks e MCP Server).

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:

  1. Existe integração pronta? Se sim, ative pelo painel e pule a parte de código.
  2. Preciso reagir a um evento? Webhook customizado ou n8n.
  3. Preciso buscar/escrever dados? API REST.
  4. Quero IA externa operando o SiteUp? MCP Server.
  5. 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:

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.

Esse artigo respondeu sua duvida?

Falar com o time