Visão geral das integrações disponíveis no Codewo. Cada uma serve a um caso de uso diferente — escolha a certa baseado em quem precisa puxar/empurrar dados.
O que é "integração" no Codewo
"Integração" aqui é o jeito de o Codewo conversar com outras ferramentas. Você pode:
- Receber dados de fora (alguém chama API do Codewo).
- Enviar dados pra fora (Codewo chama API externa).
- Conectar a serviço terceiro pra sincronizar (Google Calendar, por exemplo).
Cada caso usa uma ferramenta diferente.
Opções disponíveis
Em Configurações → Integrações:
API Keys (REST API)
Permite que sua aplicação ou ferramenta externa leia e modifique dados do Codewo via REST. Útil pra:
- Site customizado puxando lista de contatos.
- Dashboard externo agregando métricas.
- Importação de leads de outra ferramenta.
Detalhes em API Keys: criar e revogar.
Webhooks outbound
Permite que o Codewo notifique sua aplicação quando algo acontece. Em vez de você ficar perguntando "tem conversa nova?", o Codewo manda um aviso na hora.
Útil pra:
- CRM externo recebendo contato novo do Codewo.
- Sistema de billing sendo notificado de cancelamento.
- Slack/Discord recebendo alerta de conversa urgente.
Detalhes em Webhooks outbound: guia completo.
Google Calendar
Sincroniza eventos da Agenda do Codewo com seu Google Calendar (e vice-versa, dependendo da configuração). Útil pra:
- Reuniões agendadas no Codewo aparecem no Google.
- Convite manda email automaticamente pros participantes.
- Não ter "dois calendários" desencontrados.
Configuração via OAuth — você autoriza com login Google, Codewo guarda token e usa.
Como escolher
| Cenário | Use |
|---|---|
| Sua aplicação consulta dados do Codewo | API Keys |
| Sua aplicação modifica dados no Codewo | API Keys |
| Sua aplicação reage a eventos do Codewo em tempo real | Webhooks |
| Você quer sincronizar agenda com Google | Google Calendar |
| Conexão simples Zapier/Make | API Keys (HTTP) ou Webhooks |
Combinando integrações
Caso típico: CRM externo (HubSpot, Pipedrive, etc.) sincronizando com Codewo.
- Webhook outbound "contact.created" → seu CRM recebe contatos novos do Codewo.
- API Key com scope de escrita em contatos → seu CRM pode atualizar dados do contato no Codewo (ex: marcar "convertido em cliente").
- Workflow dispara "Enviar email via CRM externo" → ação HTTP request usando API do CRM.
Os três trabalham juntos. Você escolhe quantos precisa.
Pegadinhas comuns
- API Keys e Webhooks compartilham permissões e capability. Se o plano não suporta integrações, ambos ficam bloqueados.
- Não há marketplace de integrações prontas. Cada conexão você implementa via API/Webhook ou usa Zapier/Make como ponte. Sem "1-clique" pra HubSpot/Salesforce.
- Google Calendar requer reautenticação periódica. Token Google expira; precisa renovar pelo OAuth (~6 meses).
- Webhook em loop. Se você cria automação no sistema externo que volta pro Codewo (que gera webhook que volta pro externo), atenção pra não fazer ping-pong infinito.
- Limites de rate. API Keys têm rate limit. Webhook tem retry com backoff. Sistemas externos com bursts grandes podem estourar e perder eventos.
Boas práticas
- Comece com webhook + 1 API key específica. Não crie 10 chaves "geral" — uma por integração, escopo mínimo.
- Documente integrações internamente. Em 6 meses ninguém lembra qual chave faz o quê.
- Use IP whitelist em API Keys quando sua aplicação tem IP fixo — Segurança extra.
- Monitore falhas. Webhook com falhas constantes pode ser auto-desabilitado. API com 401 frequente pode indicar chave revogada ou expirada.
- Versione integrações. Quando trocar de ferramenta externa, marque integração velha como inativa antes de excluir.