Integrações
As mensagens de webhooks, pixels, provedor de e-mail, nota fiscal, logística, WhatsApp, Telegram, API de pagamentos e MCP.
Esta página reúne as mensagens das integrações configuradas em Ferramentas e das ferramentas avançadas. A maior parte indica credenciais recusadas, conexões vencidas ou dados que o serviço de fora não aceitou. As mensagens do WhatsApp têm página própria, citada na seção do WhatsApp.
Webhooks
| Mensagem | Onde aparece | O que significa | O que fazer |
|---|---|---|---|
| Desativado automaticamente após falhar 3 vezes seguidas. | Lista de Webhooks. | O endereço não respondeu em três entregas seguidas, e o webhook foi desligado. | Corrija a URL e teste de novo para reativar. |
| Esta URL foi bloqueada porque a UTMify já é integrada nativamente. | Cadastro do webhook. | Endereços da UTMify não são aceitos como webhook. | Configure a UTMify em Ferramentas > Métricas. |
| Esta URL foi bloqueada por apontar para um endereço não permitido. | Cadastro do webhook. | O endereço aponta para um destino que o ggCheckout não aceita, como uma rede interna. | Use um endereço público, com https://. |
| Webhook da API precisa de um segredo para assinar as entregas. | Cadastro do webhook com Origem em API. | O webhook da API exige um segredo. | Preencha o segredo. |
| URL é obrigatória para testar a integração | Teste do webhook. | O teste foi pedido sem endereço. | Preencha a URL antes de testar. |
| Erro ao testar integração. Verifique se a URL está correta. | Teste do webhook. | O endereço não respondeu ao teste. | Confira a URL e se o sistema de destino está no ar. |
| Ordens de cobrança inválidas | Cadastro do webhook com Origem em API. | Alguma ordem de cobrança escolhida não existe mais. | Escolha as ordens de novo. |
Pixels e métricas
| Mensagem | Onde aparece | O que significa | O que fazer |
|---|---|---|---|
| Selecione um modo de rastreamento | Cadastro de conta da Meta ou do TikTok. | O modo de rastreamento não foi escolhido. | Escolha um dos modos. |
| Informe o Pixel ID / Informe o nome da conta | Cadastro de conta do TikTok. | O campo indicado ficou vazio. | Preencha o campo. |
| Access Token é obrigatório para Events API | Cadastro de conta do TikTok. | O modo escolhido usa a Events API, que precisa do token. | Gere o Access Token no TikTok e cole no campo. |
| Project ID do Clarity inválido | Campo do Microsoft Clarity. | O ID não tem o formato do Clarity, de 10 a 64 letras minúsculas e dígitos. | Copie o Project ID do projeto no Clarity. |
| Erro inesperado ao salvar token | Cadastro de contas de pixel ou da UTMify. | O token não foi gravado. | Salve de novo. |
Provedor de e-mail
| Mensagem | Onde aparece | O que significa | O que fazer |
|---|---|---|---|
| Seu provedor seguido do nome falhou e a quantidade de vezes nas últimas 24h. | Ferramentas > Comunicações. | O provedor de e-mail falhou, e os e-mails foram entregues pelo provedor reserva. | Confira as credenciais do provedor. |
| API key inválida. Verifique sua chave de API seguido do nome do provedor | Cadastro do provedor. | O provedor recusou a chave. | Copie a chave de novo no painel do provedor. |
| Domínio não encontrado no Mailgun. Verifique se o domínio está verificado. | Cadastro do Mailgun. | O domínio informado não está verificado no Mailgun. | Verifique o domínio no Mailgun. |
| O HTML não pode estar vazio | Templates de E-mail. | O modelo foi salvo sem conteúdo. | Preencha o HTML ou restaure o modelo padrão. |
Nota fiscal
| Mensagem | Onde aparece | O que significa | O que fazer |
|---|---|---|---|
| A conexão com o Bling expirou. | Notas fiscais e Ferramentas > Sistema ERP. | A autorização dada ao ggCheckout no Bling venceu. | Conecte o Bling de novo em Ferramentas > Sistema ERP. |
| O app GG no Bling não tem permissão para seguido da ação | Emissão da nota pelo Bling. | Falta um escopo no app do Bling, como produtos, contatos, NF-e ou NFS-e. | Habilite o escopo indicado no portal do Bling e conecte de novo. |
| Dados do cliente recusados pelo Bling. | Emissão da nota pelo Bling. | O CPF ou CNPJ, o telefone ou o endereço do pagamento não foi aceito. | Confira os dados do cliente no pagamento. |
| Não foi possível gerar a NF-e. Conclua o assistente de NF-e no Bling | Emissão da nota pelo Bling. | A configuração de NF-e no Bling está incompleta. | Conclua no Bling o ambiente, a série, o certificado digital e a natureza de operação. |
| Não foi possível gerar a NFS-e. Conclua o cadastro municipal de NFS-e no Bling. | Emissão da nota pelo Bling. | O cadastro municipal de NFS-e está incompleto. | Conclua o cadastro no Bling. |
| Dados da NFS-e inválidos. | Emissão da nota pelo Bling. | A tributação do serviço ou o cadastro do prestador está incorreto. | Confira o código de serviço (LC 116) e o cadastro de prestador no Bling. |
| Prazo de cancelamento expirado | Notas fiscais. | A NF-e passou do prazo de 24 horas da SEFAZ para cancelamento. | Emita uma NF de devolução direto no Bling. |
| O Bling está com instabilidade. Tente novamente em alguns minutos. | Emissão da nota pelo Bling. | O Bling não respondeu. | Tente de novo em alguns minutos. |
| Não foi possível identificar CPF/CNPJ + nome do comprador. | Emissão manual da nota. | O pagamento não tem o documento ou o nome do comprador. | Confira os dados do cliente no pagamento. |
| Chave API inválida. Verifique no painel da Spedy. | Conexão da Spedy. | A Spedy recusou a chave. | Copie a chave de novo no painel da Spedy. |
| Empresa não encontrada. Verifique o ID no painel da Spedy. | Conexão da Spedy. | O ID da empresa não existe na Spedy. | Copie o ID da empresa no painel da Spedy. |
| Falha ao registrar webhooks na Spedy. Conexão cancelada. | Conexão da Spedy. | A conexão não foi concluída. | Tente conectar de novo. |
| Esses campos da empresa são obrigatórios pra Spedy emitir nota fiscal. | Configuração da Spedy. | Faltam no cadastro da empresa na Spedy a Inscrição Estadual, a Inscrição Municipal ou o regime tributário. | Preencha os campos no painel da Spedy e atualize a página. |
Logística
| Mensagem | Onde aparece | O que significa | O que fazer |
|---|---|---|---|
| Token expirado. Reconecte sua conta. | Card do Melhor Envio. | A autorização do Melhor Envio venceu. | Conecte o Melhor Envio de novo. |
| Credenciais inválidas. Confira o Client ID e o Client Secret. | Conexão do Melhor Envio. | O Melhor Envio recusou as credenciais. | Copie as credenciais de novo. |
| Integração não encontrada. Salve-a e tente novamente. | Conexão do Melhor Envio. | A autorização foi pedida antes de salvar a integração. | Salve a integração e conecte de novo. |
| A autorização expirou. Inicie a conexão novamente. | Volta da tela de autorização do Melhor Envio. | A autorização demorou ou foi interrompida. | Inicie a conexão de novo. |
Quando mensagens ao comprador deixam de ser entregues, o painel mostra a faixa 1 falha crítica de entrega WhatsApp requer atenção, ou a quantidade de falhas, e um contador de entregas com problema no menu lateral. Os erros da conexão, da publicação de templates e das falhas de entrega estão em Problemas comuns.
Telegram Bot
| Mensagem | Onde aparece | O que significa | O que fazer |
|---|---|---|---|
| Formato inválido. O token tem o formato 123456789:AAH... Copie de novo do BotFather. | Cadastro do bot. | O token colado está incompleto ou com outro formato. | Copie o token de novo no BotFather. |
| Token recusado pela Telegram. | Cadastro do bot. | O Telegram não reconheceu o token. | Confira se o token foi copiado inteiro. |
| Um passo precisa de ajuste antes de publicar. | Editor do fluxo. | Algum passo do fluxo está incompleto. | Corrija o passo marcado. |
| Escolha o checkout em Pagamento. | Editor do fluxo. | Sem checkout, o bot não tem o que cobrar. | Escolha o checkout no passo Pagamento. |
| Dois produtos usam o mesmo checkout. | Editor do fluxo. | Cada produto do fluxo precisa de um checkout diferente. | Troque o checkout de um dos produtos. |
| A mensagem passa do limite do Telegram (4.096 caracteres). | Editor do fluxo. | O texto é maior que o limite do Telegram. | Reduza o texto ou divida em duas mensagens. |
API de pagamentos e MCP
| Mensagem | Onde aparece | O que significa | O que fazer |
|---|---|---|---|
| Aceite os termos para continuar | API de pagamentos. | As chaves só são criadas depois do aceite dos termos. | Aceite os termos. |
| Limite de chaves de produção atingido | API de pagamentos. | A conta chegou à quantidade máxima de chaves de produção. | Revogue uma chave sem uso. |
| O valor máximo por cobrança deve ficar entre R$ 1,00 e R$ 1.000.000,00 | Criação da chave. | O valor máximo está fora do intervalo. | Informe um valor dentro do intervalo ou deixe o campo vazio para usar o limite da conta. |
| Algum IP da lista não é válido. | Criação da chave. | Um dos IPs permitidos tem formato errado. | Confira a lista de IPs. |
| Uma das ordens de cobrança não existe mais | Criação ou edição da chave. | Uma ordem escolhida foi excluída. | Abra a chave de novo e escolha as ordens atuais. |
| Esta chave já está sendo trocada | Troca da chave. | Já existe uma troca em andamento. | Aguarde a troca terminar. |
| Chave de produção cobra compradores de verdade. | Criação da chave. | A chave cria cobranças reais. | Use uma chave de teste para testes. |
| Você só pode ter 1 API Key ativa por vez. | Ferramentas > MCP. | A conta já tem uma chave ativa. | Revogue a chave atual para criar outra. |
| Guarde esta chave em local seguro. Ela não será exibida novamente. | Ferramentas > MCP, ao criar a chave. | A chave aparece uma única vez. | Copie e guarde a chave antes de fechar a janela. |
Páginas relacionadas
- Webhooks: o cadastro, o teste e o histórico de entregas.
- Nota fiscal automática: a emissão de notas pelo Bling e pela Spedy.
- Chaves da API: a criação, a troca e a revogação das chaves.
Vendas e atendimento
As mensagens da tela Pagamentos, do reenvio de e-mail e WhatsApp, da exportação, da edição do pedido, do SAC e das defesas de MED e chargeback.
Área de membros
As mensagens da importação de alunos, das turmas, do conteúdo, das configurações da área de membros e os avisos que o aluno vê.