Integrações
Integrações representam aplicações externas vinculadas ao Pingo Notify, autorizadas a acessar recursos como conexões, planos e mensageria.
O que são integrações?
Uma integração é o vínculo entre o Pingo Notify e uma aplicação externa, como um plugin, sistema ou plataforma.
A integração não é uma sessão do WhatsApp.
Ela é a autorização que permite que uma aplicação acesse o Pingo Notify.
Por meio de uma integração, uma aplicação pode interagir com o sistema de mensageria de forma segura e controlada.
Para que servem as integrações?
As integrações permitem que aplicações externas possam:
- Enviar mensagens
- Acessar conexões disponíveis
- Consultar informações de plano
- Utilizar recursos de mensageria
- Operar dentro das permissões concedidas
Sem uma integração ativa, a aplicação não consegue acessar o Pingo Notify.
O que esta tela mostra?
A tela Integrações exibe todas as aplicações já vinculadas à sua conta do Pingo Notify.
Cada item da lista representa:
- Uma aplicação integrada (ex.: WordPress)
- Uma autorização ativa
- Um vínculo válido com o sistema de mensageria
Exemplo: Integração com WordPress
Quando você integra o plugin WordPress ao Pingo Notify:
- O WordPress passa a ser uma integração
- A conta WordPress ganha acesso ao sistema de mensageria
- O plugin pode:
- Listar conexões
- Usar conexões ativas
- Consultar informações do plano
- Enviar mensagens por eventos do site
A integração libera o acesso.
A conexão define qual WhatsApp será usado.
Integração x Conexão
- Integração: vínculo com a aplicação (ex.: WordPress)
- Conexão: sessão do WhatsApp (QR Code escaneado)
Uma integração pode usar uma ou mais conexões, dependendo da configuração.
Integrações de IA (OpenAI e Anthropic)
Há dois sentidos de integração, e eles são opostos:
- Aplicação → Pingo (ex.: WordPress): a autorização para um sistema externo usar o Pingo Notify.
- Pingo → provedor (ex.: OpenAI, Anthropic): a credencial que o Pingo usa para chamar um serviço externo em seu nome.
As integrações de IA são do segundo tipo e estão disponíveis em qualquer plano.
O que elas guardam
Apenas a chave de API. Nada além disso.
Não existe "modelo padrão" na integração. Quem escolhe o modelo é quem usa, e a escolha é obrigatória — assim, trocar uma credencial nunca muda o comportamento de um agente que ninguém editou.
A chave é somente-escrita: ela nunca volta pela API. Ao editar, deixar o campo em branco preserva a chave guardada — é assim que se troca o token sem reinstalar.
Quem usa a credencial
Dois recursos do helpdesk, independentes entre si:
- Agentes de IA — respondem o cliente sozinhos. Cada agente escolhe a sua integração e o seu modelo.
- Assistente do composer — o botão de IA na caixa de resposta do atendente (sugerir, reescrever, corrigir, resumir). Tem a própria configuração.
Desativar ou remover a integração deixa mudo todo agente que apontava para ela, e apaga o botão de IA do composer. Nada é perdido: religar a integração restaura os dois.
Modelos
A lista de modelos é lida ao vivo da API do provedor, com a sua chave — não há catálogo fixo no Pingo. Se a chave não tiver permissão para listar modelos, ela ainda gera: informe o modelo manualmente.
O que posso fazer com uma integração?
Nesta tela, você pode:
- Visualizar quais aplicações estão integradas
- Identificar a origem do acesso (ex.: plugin, sistema, API)
- Controlar quais aplicações têm acesso ao Pingo Notify
- Revogar integrações que não devem mais acessar o sistema
Importante saber
Se uma integração for removida ou desativada,
a aplicação vinculada perde imediatamente o acesso ao Pingo Notify.
Isso não remove conexões nem mensagens, apenas bloqueia o acesso da aplicação.
Resumo
- Integração = autorização de acesso da aplicação
- Plugin WordPress é um exemplo de integração
- Integrações acessam conexões e recursos do plano
- Sem integração, a aplicação não funciona
Antes de uma aplicação enviar mensagens ou gerenciar conexões, ela precisa estar integrada ao Pingo Notify.