Integração Comtele <> Zabbix
Receba alertas críticos de infraestrutura diretamente no seu celular. Configure o Zabbix para enviar notificações de triggers via SMS usando a API da Comtele.
O que você precisa antes de começar
Chave API (API Key)
Acesse a plataforma da Comtele e copie sua API Key, necessária para autenticar o envio de mensagens.
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
Escolha sua forma de integração
Existe uma forma possívei de integração com o Zabbix:
Ideal para: Receber alertas críticos de infraestrutura diretamente no seu celular.
- Estrutura do Script
Crie a pasta:
/usr/lib/zabbix/alertscripts/comtele_sms.shDentro dela, crie o arquivo bash:
COMTELE_SMS.SH
#!/bin/bash
# $1: {ALERT.SENDTO} | $3: {ALERT.MESSAGE}
API_KEY="SUA_CHAVE_API_DA_COMTELE"
ENDPOINT="https://api.comtele.com.br/v2/sms/send"
# Requisição para a API da Comtele
curl -s -X POST "$ENDPOINT" \
-H "Content-Type: application/json" \
-H "auth-key: $API_KEY" \
-d "{ \"Receivers\": [\"$1\"], \"Content\": \"$3\"}"
Disparo do SMS:
comtele_sms.sh
API_KEY="SUA_CHAVE_API_DA_COMTELE"
DESTINO="$1"
MENSAGEM="$2"
ENDPOINT="https://api.comtele.com.br/v2/sms/send"
# Codifica a mensagem para evitar erro com espaço e acentos
MENSAGEM_ENCODED=$(echo "$MENSAGEM" | sed 's/ /%20/g')
# Faz a requisição para a API da Comtele
curl -X POST "$ENDPOINT" \
-H "Content-Type: application/json" \
-H "auth-key: $API_KEY" \
-d "{
\"Receivers\": \"$DESTINO\",
\"Content\": \"$MENSAGEM\"
}"
- Permissões Terminal
Dentro do: Terminal, o úsuario zabbix necessita executar o codigo para que gere as ações
TERMINAL
# Conceder permissão de execução
chmod +x /usr/lib/zabbix/alertscripts/comtele_sms.sh
# Definir o usuário do Zabbix como dono do arquivo
chown zabbix:zabbix /usr/lib/zabbix/alertscripts/comtele_sms.sh
- Instalar o Plugin
- Vá até o menu: Administração → Tipos de Mídia → Criar Tipo de Mídia.
-
Nome:
Comtele SMS - Tipo: Script
- Nome do Script: comtele_sms.sh
- Parâmetros importantes
- {ALERT.SENDTO}
- {ALERT.SUBJECT}
- {ALERT.MESSAGE}
Verifique se tudo funcionou bem
- Mídia do Usuário: Vá no seu usuário (Perfil) e adicione o "Comtele SMS" informando seu número com DDD.
-
Ação de Trigger: Configure uma Ação em
Configuração → Açõespara enviar mensagem para o seu usuário quando um host cair. -
Monitor de Envios: Verifique em
Relatórios → Log de Açõesse o status do envio está como "Enviado".
Institucional
Aplicações
Desenvolvedores
Segurança
