Em Configurações → Integrações ficam as portas do Codewo para outros sistemas. Integrações Externas conecta contas prontas (Google Calendar & Meet e Bling). API & Chaves deixa um sistema seu ler e gravar dados aqui. Webhooks avisa um sistema seu na hora em que algo acontece. E, dentro das Automações, o gatilho Webhook de outro sistema deixa um sistema de fora disparar uma automação.
O que é
| Você quer... | Use | Onde |
|---|---|---|
| Criar reuniões com link do Meet e ver sua agenda do Google na Agenda | Google Calendar & Meet | Integrações → Integrações Externas |
| Trazer catálogo, pedidos e clientes do ERP Bling | Bling | Integrações → Integrações Externas |
| Que um sistema seu consulte ou grave contatos, mensagens, produtos e pedidos | API & Chaves | Integrações → API & Chaves |
| Que um sistema seu saiba na hora de uma conversa nova, um contato, um pedido ou uma proposta aceita | Webhooks | Integrações → Webhooks |
| Que uma loja, uma plataforma de cursos ou um formulário dispare uma automação aqui | Gatilho Webhook de outro sistema | Automações |
| Que uma automação chame outro sistema e use a resposta | Passo Chamar um sistema externo | Automações |
Como funciona
O que aparece no menu
- Ver as telas de Integrações pede a permissão Ver integrações. Conectar, criar, alterar e desconectar pede Gerenciar integrações.
- Cada tela depende do plano: Integrações Externas, API & Chaves e Webhooks só aparecem quando o plano da empresa inclui aquele recurso. Se nenhuma estiver no plano, o item Integrações some do menu.
- O cartão do Bling só aparece quando o plano inclui o Catálogo.
Integrações Externas
A tela separa as integrações em abas por categoria (Todos, Produtividade e, quando o Bling aparece, ERP) e em duas seções: Conectadas e Disponíveis. No fim de Disponíveis, o cartão Solicitar integração ("Não encontrou o que precisa?") abre um pedido de ideia já marcado como integração, para a equipe do produto avaliar.
Google Calendar & Meet
- Conectar. Clique no cartão Google Calendar & Meet em Disponíveis, entre com a conta Google e marque todas as permissões pedidas, inclusive "Ver e editar eventos no seu calendário". Sem ela, a conexão é recusada.
- Várias contas. O cartão continua em Disponíveis para conectar outra conta. Cada conta conectada vira um cartão próprio em Conectadas, com o e-mail dela.
- Conta padrão. A primeira conta conectada vira a Padrão. Para trocar, clique em Definir padrão em outra. Ao criar uma reunião com Meet na Agenda, a conta padrão vem escolhida, e você pode trocar por outra conectada.
- Sincronizar eventos desta conta. Ligada, os eventos do Google aparecem na Agenda do Codewo como itens somente leitura, atualizados a cada 15 minutos. A primeira carga traz 30 dias para trás e 90 para a frente. O cartão mostra quando foi a última sincronização.
- O que vai para o Google. Só as reuniões com Meet criadas no Codewo: o Google recebe o evento com o link, e reagendar ou cancelar aqui atualiza lá. Tarefas, ligações e lembretes ficam só no Codewo.
- Token expirado. O cartão fica amarelo com "Token expirado — requer ação". Clique em Reconectar e autorize de novo.
- Desconectar. Passe o mouse sobre o cartão e clique no ícone de desconectar. Se houver reuniões futuras criadas por aquela conta, ela fica Desativada para não perder o vínculo: os eventos continuam no Google, mas não dá para cancelar ou reagendar pelo Codewo até reconectar.
Bling
A integração com o ERP Bling traz catálogo, pedidos e os clientes de cada pedido, e pode enviar de volta o que for vendido aqui. Ela está em liberação: fale com o suporte antes de conectar. Clique no cartão Bling para abrir a tela própria dela. O passo a passo está em Integração com o Bling.
API & Chaves
Para um sistema seu (site, loja, ERP próprio) conversar com o Codewo. Em Criar chave, você dá um nome, escolhe o que a chave pode fazer (ler contatos, gravar pedidos, enviar mensagens e assim por diante) e, se quiser, limita os IPs de onde ela aceita chamadas. A chave aparece uma única vez. A tela mostra o uso dos últimos 30 dias, as últimas 100 chamadas de cada chave e o botão para revogar. O botão Documentação leva à referência técnica. Detalhes em Chaves de API: criar, usar e revogar.
Webhooks
O caminho inverso: o Codewo manda um aviso assinado para o endereço do seu sistema quando acontece um dos 11 eventos (conversa criada, atribuída, com status alterado ou encerrada; contato criado, atualizado ou etiquetado; pedido criado, com situação alterada ou entregue; proposta aceita). Em Novo endpoint, informe o endereço (só https://) e escolha os eventos. O segredo de assinatura aparece uma única vez. Cada endpoint tem Testar, Ver entregas (com Reenviar), Rotacionar secret e Pausar. Detalhes em Começando com Webhooks e Webhooks de saída: guia completo.
Gatilho de automação "Webhook de outro sistema"
Quando o sistema de fora não fala a língua da API (uma plataforma de cursos ou uma loja pronta mandam o formato delas), use uma automação com o gatilho Webhook de outro sistema. Cada automação ganha um link próprio. O sistema de fora chama esse link, o Codewo procura o contato pelo e-mail ou pelo telefone que vierem no aviso e segue os passos da automação. Veja Webhook de entrada nas Automações.
Passo a passo: loja virtual própria conectada ao Codewo
Cenário: uma loja de cosméticos vende pelo site próprio e atende pelo WhatsApp no Codewo. O desenvolvedor da loja quer três coisas.
- Pedido do site aparecer no Codewo. Em API & Chaves, clique em Criar chave, dê o nome "Site da loja" e marque só a gravação de pedidos e a leitura de produtos. O site passa a registrar cada venda no Codewo com o número do pedido dele, e um reenvio do mesmo pedido não gera venda em dobro.
- Cliente novo do WhatsApp entrar no cadastro da loja. Em Webhooks, clique em Novo endpoint, informe o endereço que o desenvolvedor passou e marque contact.created. Use Testar para conferir se chega.
- Avisar o cliente quando o pedido sair para entrega. Em Automações, crie uma automação com o gatilho Webhook de outro sistema e o passo Enviar mensagem ("Seu pedido saiu para entrega!"). Copie o link do gatilho e entregue ao desenvolvedor: a loja chama esse link, com o telefone do cliente, quando despacha. A mensagem sai na conversa mais recente do cliente. No WhatsApp oficial, quem não escreve há mais de 24 horas só recebe modelo aprovado: nesse caso, escolha Modelo aprovado (fora das 24h) no passo.
- Uma semana depois, abra Ver entregas no endpoint e as últimas chamadas da chave para conferir se tudo está chegando.
Pegadinhas comuns
- Não achou a tela? Pode ser o plano. Integrações Externas, API & Chaves e Webhooks somem do menu quando o plano não inclui o recurso. Fale com quem administra a conta.
- Ver não é gerenciar. Quem tem só Ver integrações enxerga as telas, mas não conecta nem cria nada.
- Chave e segredo aparecem uma vez só. Guarde num cofre de senhas na hora. Perdeu, crie outra chave ou rotacione o segredo.
- Eventos do Google são somente leitura aqui. Para mudar um evento que veio do Google, mude no Google.
- Webhook pausa sozinho. Depois de 5 falhas seguidas, o endpoint é pausado e quem o criou recebe um aviso. Reativar volta a enviar dali em diante; o que falhou no meio tempo só volta com Reenviar, entrega por entrega.
- A API não recebe o formato de outros sistemas. Para receber o aviso de uma plataforma pronta, use o gatilho Webhook de outro sistema, não a API.
- O gatilho de entrada não cria contato. Se o e-mail ou o telefone do aviso não baterem com um contato existente, a automação não tem com quem seguir.
- Cuidado com o pingue-pongue. Uma automação que chama um sistema que, por sua vez, chama o Codewo de volta pode entrar em ciclo. Desenhe o caminho antes.
- Há limite de chamadas por minuto na API, por chave e por empresa. Integração que dispara em rajada recebe recusa temporária e precisa tentar de novo em seguida.
- Não há catálogo de conectores prontos além dos listados. Para outros CRMs, ERPs e lojas, use API e Webhooks diretamente ou uma ferramenta de integração sem código que faça chamadas por HTTP.
Boas práticas
- Uma chave por integração, com o mínimo de permissões. Se uma vazar, você revoga só ela.
- Restrinja IPs quando o sistema que chama tem endereço fixo.
- Nomeie tudo pelo uso. "Site da loja", "ERP financeiro". Daqui a seis meses ninguém lembra para que servia "Chave 2".
- Olhe as entregas e as chamadas de tempos em tempos. Falha silenciosa é a que custa mais caro.
- Conta padrão do Google de uso comum. Prefira uma conta da empresa, e não a pessoal de alguém que pode sair.