Canais API customizados
Nem todo canal de comunicação tem conector nativo na SiteUp — e tudo bem. Para esses casos, a plataforma oferece o canal API customizado, um tipo de caixa que aceita mensagens vindas de qualquer origem e devolve respostas pelo mesmo caminho. É a ponte universal para conectar Telegram, RCS, mensagens dentro do seu próprio aplicativo, SMS via gateway terceiro ou qualquer outro fluxo de mensagens bidirecional.
Quando usar este tipo de caixa
Considere um canal API customizado quando:
- O canal que você precisa atender ainda não está na lista de conectores nativos
- Você opera um app móvel próprio e quer um chat de suporte dentro dele
- Tem uma operação de SMS e quer que respostas caiam no mesmo painel do WhatsApp
- Precisa expor um endpoint para um bot, integrador ou parceiro alimentar conversas
A vantagem é que, do ponto de vista do atendente, a conversa parece igual a qualquer outra. Toda a inteligência da SiteUp — Capitão IA, atribuição, etiquetas, kanban, relatórios — funciona normalmente.
Como o fluxo funciona
A integração com um canal API tem dois lados:
| Direção | O que acontece |
|---|---|
| Cliente → SiteUp | Sua aplicação recebe a mensagem do cliente e a envia via POST para o endpoint da SiteUp |
| SiteUp → cliente | Quando o atendente responde, a SiteUp dispara um webhook para a URL configurada por você, e sua aplicação entrega a mensagem ao cliente |
Esse modelo deixa sua aplicação responsável apenas pela "última milha" (entregar e receber em qualquer canal exótico), enquanto a SiteUp cuida da inteligência de atendimento.
Conceitos importantes
Identificador único de contato
Cada interlocutor precisa ter um identificador estável, pois é por ele que a SiteUp mantém o histórico. Pode ser um e-mail, um ID de usuário do seu sistema, um número de Telegram — o que fizer sentido. Mensagens com o mesmo identificador são agrupadas na mesma ficha de contato.
Tipos de conteúdo suportados
A API aceita os seguintes formatos de mensagem:
- Texto simples
- Imagem com legenda
- Vídeo, áudio e documento (anexos genéricos)
- Mensagens com botões interativos (texto + ações)
- Notas de áudio gravadas
Se o canal de destino não suporta algum formato, sua aplicação deve lidar com a degradação (por exemplo, transcrever áudio em texto antes de entregar).
Autenticação
A SiteUp gera um token específico por canal API criado. Esse token deve ser usado em todas as chamadas que enviam mensagens à plataforma. O webhook reverso (saída) é assinado para que sua aplicação possa validar que a chamada veio mesmo da SiteUp.
Exemplos comuns de integração
| Canal | Como o canal API ajuda |
|---|---|
| Telegram | Bot do Telegram repassa mensagens para a API; respostas voltam via webhook |
| RCS | Gateway RCS converte mensagens em chamadas à API |
| App proprietário | SDK do seu app envia/recebe pelos endpoints |
| SMS via gateway | Gateway de SMS dispara para o webhook quando recebe; SiteUp responde via API do gateway |
| Live chat de marketplace | Plataforma de e-commerce fala com a SiteUp como ponte unificada |
O que acontece no painel
Para o atendente, uma conversa vinda de canal API se comporta exatamente como uma conversa de WhatsApp ou e-mail:
- Aparece na lista de conversas com o identificador como nome (até que se atribua um contato real)
- Permite resposta com texto, anexos e modelos prontos
- Pode ser atribuída a um atendente ou equipe
- Entra no kanban se houver pipeline configurado para essa caixa
- O Capitão IA pode atender primeiro, exatamente como em outros canais
Limitações
- Mídia muito grande pode demorar mais para ser transmitida — a SiteUp limita anexos a 100 MB por mensagem
- Mensagens com formatação rica específica de um canal (botões interativos do RCS, por exemplo) podem precisar de adaptação na sua aplicação
- A plataforma não armazena indefinidamente arquivos enviados — o ideal é que sua aplicação também guarde cópia se a retenção for longa
Próximos passos
- Visão geral de canais — combinar canal API com canais nativos
- Documentação de API pública — referência técnica para integradores
- Webhooks da SiteUp — eventos disponíveis para automatizar fora da plataforma