Gerencie uma conta de envio do Telegram no console do Chat App Message Service. Isso inclui visualizar informações do bot, gerenciar bots conectados e configurar webhooks.
Pré-requisitos
Procedimento
Acesse a página de gerenciamento de contas de envio
Faça login no Chat App Message Service console.
No painel de navegação à esquerda, escolha Instant Message > Telegram.
Na lista de contas de envio, clique no nome da conta de envio que deseja gerenciar. A página de detalhes da conta de envio é aberta.
Visualize as informações do bot
Na página de detalhes da conta de envio, clique em Chatbot Management para visualizar os bots do Telegram conectados à conta de envio:
Nome do bot: o nome do bot do Telegram conectado.
Endereço do bot: a URL de acesso do bot do Telegram conectado.
Token: o token de API do bot do Telegram conectado.
Gerenciamento de bots
Atualize um token
Se o token de API de um bot vazou ou expirou, atualize o token no console.
Atualizar um token substitui o token existente. Pode ocorrer uma breve desconexão durante o processo, afetando o envio de mensagens. Execute esta operação em horários de menor pico.
No cliente do Telegram, abra o BotFather e gere um novo token de API para o bot de destino.
Na página Chatbot Management, clique em Update Token.
Na caixa de diálogo exibida, cole o novo token de API.
Clique em OK.
Exclua um bot
Para excluir um bot conectado à conta de envio, execute as etapas a seguir:
Após excluir um bot, você não poderá mais enviar mensagens por meio dele. A exclusão não pode ser desfeita. Proceda com cuidado.
Na página Chatbot Management, clique em Delete.
Na caixa de diálogo de confirmação exibida, clique em OK.
Reconecte um bot
Se você excluiu um bot ou deseja substituir um bot existente, conecte um novo bot:
Na página Chatbot Management, clique em Connect Existing Bot.
Insira o token de API do novo bot e clique em Connect para concluir a autorização.
Configurações de webhook
Use um webhook para receber notificações de recebimento de mensagens, como callbacks de entrega de mensagens e status de leitura.
Para obter mais informações sobre recebimentos de mensagens, consulte Receipt message overview and configuration.
Na página Chatbot Management, clique em Configure Webhook.
-
Na caixa de diálogo Webhook Settings, configure os seguintes parâmetros:
Parâmetro
Descrição
HTTP Protocol
Ative ou desative URLs de callback HTTP. Quando ativado, os campos Status Report Callback URL, MO Message Callback URL e Notification Callback URL tornam-se obrigatórios.
Status Report Callback URL
A URL de callback HTTP para receber relatórios de status de entrega de mensagens. Obrigatório quando o HTTP Protocol está ativado.
MO Message Callback URL
A URL de callback HTTP para receber callbacks de mensagens com origem no dispositivo móvel (MO). Obrigatório quando o HTTP Protocol está ativado.
Notification Callback URL
A URL de callback HTTP para receber callbacks de notificação de auditoria. Obrigatório quando o HTTP Protocol está ativado.
Message Queue Monitoring
Ative ou desative o monitoramento da fila de mensagens.
Message Receipt Queue
O nome da fila para o status de entrega de mensagens. Somente leitura. Clique no ícone de cópia para copiar o nome da fila.
MO Message Queue
O nome da fila para mensagens MO. Somente leitura. Clique no ícone de cópia para copiar o nome da fila.
Notification Queue
O nome da fila para notificações de auditoria. Somente leitura. Clique no ícone de cópia para copiar o nome da fila.
Clique em OK e salve as configurações.
Próximas etapas
Após conectar um bot à conta de envio, você pode executar as seguintes operações:
Crie modelos de mensagens. Para obter instruções, consulte Template design.
Envie mensagens para os usuários. Para obter instruções, consulte Send message.