Integração Comtele <> Traccar
Envie SMS diretamente pelas campanhas do Traccar usando a API da Comtele. Simples, rápido e sem intermediários.
O que você precisa antes de começar
Chave API (API Key)
Acesse a plataforma da Comtele e localize sua Chave API. Você precisará dela para autenticar as requisições enviadas pelo Traccar.
Endpoint de Envio
O endpoint da API da Comtele utilizado para envio de SMS:
https://sms.comtele.com.br/v2/sms/send
https://sms.comtele.com.br
/v2/sms/send
O Traccar tem suporte a notificadores configuráveis e permite definir notificator.types (ex.: web,mail,sms) e parâmetros como sms.http.url, sms.http.template, sms.http.authorization, etc. Muitos usuários usam essas chaves para encaminhar SMS via HTTP. Nos exemplos abaixo usamos esse mecanismo para fazer a Traccar chamar a API da Comtele.
Passo a passo para integração
Ideal para: você quer apenas enviar SMS quando uma campanha dispara um evento específico (ex: novo lead, formulário preenchido etc.).
- Localizar o arquivo
O arquivo geralmente está em:
Caminho do arquivo (traccar.xml)
"opt/traccar/conf/traccar.xml"
Ou
Caminho alternativo do arquivo
"/etc/traccar/traccar.xml"
- Editar o arquivo
Adicione (ou edite) as seguintes entradas:
Configuração da API (web.xml)
"/
web,mail,sms
https://api.comtele.com.br/v2/sms/send
POST
{"Receivers":["{sendTo}"],"Content":"{message}"}
application/json
auth-key: SUA_CHAVE_API_DA_COMTELE
"
- ⚠️ Substitua SUA_CHAVE_API_DA_COMTELE pela sua chave real disponível no painel Comtele.
- Reiniciar o serviço
Após salvar as alterações:
Comando de reinicialização do serviço
sudo systemctl restart traccar"
- Configuração no Painel Traccar
- Acesse o painel web como Administrador.
- Vá em Configurações → Notificações (Settings → Notifications).
- Clique em Adicionar (+).
- Selecione o tipo de evento (ex: desconexão, cerca eletrônica, etc.).
- Associe a notificação aos dispositivos desejados e salve.
- Teste de Envio
Faça um teste manual para garantir que o servidor consegue enviar mensagens via API:
Requisição de teste (curl)
curl -X POST "https://api.comtele.com.br/v2/sms/send" \
-H "Content-Type: application/json" \
-H "auth-key: SUA_CHAVE_API_DA_COMTELE" \
-d '{"Receivers":["5511999999999"],"Content":"Mensagem de teste do Traccar"}'"
Se a resposta retornar algo como:
Resposta esperada da API
{"Success": true, "Message": "Message sent successfully"}
a integração está funcionando corretamente.
- Logs e Diagnóstico
Verifique o log do Traccar em caso de falha:
Log do sistema (traccar)
/opt/traccar/logs/tracker-server.log
Verifique:
- Conectividade com a internet
- Chave API válida
- Permissões e sintaxe do JSON no template.
- Exemplo de Configuração Completa (traccar.xml)
Exemplo completo de configuração (traccar.xml)
/
web,mail,sms
https://api.comtele.com.br/v2/sms/send
POST
{"Receivers":["{sendTo}"],"Content":"{message}"}
application/json
auth-key: SUA_CHAVE_API_DA_COMTELE
Verifique se tudo funcionou bem
- Crie uma campanha no Traccar com um gatilho simples: "Quando o contato for adicionado à campanha → Enviar SMS (Comtele SMS)".
- Escolha o canal Comtele SMS e defina a mensagem.
- Execute a campanha e veja o SMS sendo entregue.
Institucional
Aplicações
Desenvolvedores
Segurança
