Criar a conta na Comtele e obter a chave de API

O envio de SMS pelo sistema depende de uma conta própria da empresa na Comtele. É nessa conta que ficam os créditos consumidos a cada mensagem. O sistema não envia por uma conta da TryIdeas — cada cliente contrata a sua, e é por isso que o custo do SMS aparece diretamente na fatura da Comtele.
O que você precisa tirar dessa conta é uma chave de API (também chamada de token), que será informada nas configurações do sistema.
Este capítulo trata apenas da criação da conta e da obtenção da chave. Depois de obtê-la, siga para Notificações por SMS nos eventos do Kanban → Passo 1 — Configurar a conta de envio.

Passo 1 — Criar a conta
Acesse https://comtele.com.br/precos-comtele/#contateste e faça o cadastro.
Nessa página estão os planos e a opção de conta de teste, que permite validar a integração antes de contratar volume. Confirme os valores e as condições diretamente com a Comtele — preço por mensagem e validade dos créditos são informações comerciais que mudam com o tempo.
Conclua o cadastro e confirme o e-mail, se solicitado.

Passo 2 — Abrir as Configurações da Conta
Já dentro do painel da Comtele, clique sobre o seu usuário, no canto superior direito, e depois em Configurações.

Abre a tela Configurações da Conta, com várias abas (Informações Básicas, Informações da Empresa, Endereço, Chaves de API, Restrição de IP, Webhooks, entre outras).
Clique na aba Chaves de API.

Passo 3 — Criar a chave

Clique em + Nova Chave.
Em Nome da Chave, informe algo que identifique o uso — por exemplo "TryERP — Notificações". O nome é apenas para você reconhecer a chave depois; não afeta o funcionamento.

Desligue a opção Expirar após 30 dias sem uso.
Clique em Criar chave.

Por que desligar a expiração: com a opção ligada, a chave é desativada automaticamente se ficar 30 dias sem ser usada. Numa empresa que notifica por SMS apenas em alguns eventos, é perfeitamente possível passar um mês sem nenhum envio — e aí, no dia em que o SMS fosse realmente necessário, ele falharia por credencial desativada, sem ninguém ter mudado nada. Deixe a opção desligada.
A chave completa é exibida uma única vez, logo após a criação. Depois disso o painel mostra apenas parte dela, e não há como recuperá-la. Copie e guarde em local seguro antes de fechar a janela. Se a chave for perdida, o caminho é criar uma nova e substituir no sistema.
Trate a chave como uma senha: quem tiver acesso a ela pode enviar SMS às custas da sua conta. Não envie por e-mail, WhatsApp ou anexo de chamado.

Passo 4 — Informar a chave no sistema
De volta ao sistema, vá em Configurações → Configurações Adicionais, aba Notificações (SMS), e cole a chave no campo Token da filial desejada. A chave é gravada criptografada.
Em seguida, use o botão Consultar Rotas para descobrir as rotas disponíveis na sua conta e preencher o campo Rota, e depois Testar Envio para confirmar que está tudo certo. O detalhamento de cada campo está no capítulo das notificações por SMS.
Sobre a rota: a Comtele costuma oferecer uma rota de marketing (mais barata) e uma transacional, às vezes chamada de Premium. Use a transacional. Na rota de marketing as operadoras podem levar até 1 hora para concluir os envios, o que não serve para avisar um cliente sobre o pedido dele. Na Comtele a rota também é quem define o remetente que aparece no celular — por isso não existe campo de remetente configurável.

Acompanhar o saldo
O saldo em reais fica visível no canto superior direito do painel da Comtele, ao lado do usuário. Cada mensagem enviada consome desse saldo.
Sem saldo, o SMS simplesmente não sai. O sistema registra a falha no histórico de notificações, mas não há como adivinhar o fim do crédito antes que aconteça — e o pedido segue seu fluxo normalmente, sem que ninguém seja avisado na hora. Para evitar a surpresa, configure a aba Alerta de Saldo nas Configurações da Conta da Comtele, para receber aviso quando o crédito estiver baixo.

Se a chave não funcionar
A Comtele mantém dois painéis diferentes, com credenciais que não são intercambiáveis. Uma chave criada em um painel é recusada pelo outro, com erro de autenticação.
A chave que o sistema utiliza é a criada pelo caminho descrito aqui — Configurações da Conta → Chaves de API, no painel que exibe o saldo no topo. Se ao usar o Testar Envio aparecer erro de autenticação mesmo com a chave recém-copiada, verifique se ela foi criada nesse painel, e não em um acesso antigo da Comtele que a empresa porventura já tivesse.

Erro no Testar Envio
O que verificar

Falha de autenticação
Chave copiada incompleta, chave já desativada, ou chave criada no painel errado (acima).

Rota não cadastrada para o usuário
Campo Rota vazio ou com número que não existe na conta. Use Consultar Rotas.

Saldo insuficiente
Recarregue os créditos no painel da Comtele.

Número inválido
Confira DDD e quantidade de dígitos do celular usado no teste.

Manual de Pedidos — Conta na Comtele — Rev 1 (2026-09-12). Configuração no sistema: ucConfiguracoesAdicionais, aba Notificações (SMS).