Instalação e configuração
Instalar o aplicativo
Acesse o aplicativo ClickSend SMS no Zendesk Marketplace.
Clique em Instalar, em seguida, escolha sua conta do Zendesk.
Clique em Instalar novamente para confirmar.
Autenticar com o ClickSend
No Zendesk, acesse a Central de administração > Aplicativos e integrações > ClickSend SMS.
Insira seu nome de usuário do ClickSend e a chave de API (encontrada aqui).
Clique em Conectar ao ClickSend.
Uma vez conectado, seu histórico de SMS será preenchido.
Enviar SMS do Zendesk
Há três maneiras de enviar SMS no Zendesk:
1. Barra superior (Quick SMS – Recomendado)
Acessível de qualquer página no Zendesk.
Ideal para mensagens rápidas e personalizadas para contatos.
2. Barra lateral do chamado
Use ao trabalhar em um chamado com um número de telefone salvo.
Ideal para respostas de atendimento ao cliente dentro de conversas.
3. Barra de navegação (Mensagens em massa)
Enviar SMS individuais ou em massa para grupos ou organizações.
Ótimo para anúncios, promoções ou alertas.
Recebendo SMS inbound
As respostas aparecem em tempo real no seu painel do Zendesk.
Mensagens não lidas mostram um indicador de ponto vermelho.
Nota: O Zendesk pode não mostrar as respostas se a sua conta ClickSend tiver mais de 10 regras inbound. Saiba mais sobre as Regras inbound.
Dica: Verifique regularmente seu painel para garantir respostas oportunas.
SMS automatizado via Webhook + Acionadores
Use os acionadores do Zendesk para enviar SMS automaticamente quando ocorrerem atualizações no chamado.
Criar um Webhook
Acesse a Central de administração > Aplicativos e integrações > Webhooks.
Clique em Criar Webhook.
Use as seguintes configurações:
URL do ponto de extremidade: https://rest.clicksend.com/v3/sms/send
Método: POST
Formato: JSON
Autenticação: Basic Auth (nome de usuário do ClickSend + chave de API)
Adicionar um Acionador
Acesse Acionadores > Adicionar acionador.
Escolha uma categoria (ex., Chamados).
Adicione uma ação:
Notificar webhook ativo → selecione seu webhook do ClickSend.
Adicione isso ao corpo do JSON:
Mensagem básica:
{
"messages": [
{
"to": "+61411111111",
"source": "zendesk",
"body": "esta é uma mensagem de teste"
}
]
}Exemplo dinâmico:
{
"messages": [
{
"to": "##{{current_user.phone}}",
"source": "zendesk",
"body": "Olá ##{{current_user.first_name}}, o status de ##{{ticket.brand.name}} foi alterado para ##{{ticket.status}}."
}
]
}
FAQs
Como eu me autentico?
Use seu nome de usuário do ClickSend e chave de API (não a sua senha).
Posso rastrear a entrega de SMS?
Sim, o status do SMS pode ser rastreado através da Barra superior, Barra lateral e Barra de navegação.
Posso enviar mensagens em massa?
Sim, use a Barra de navegação e selecione um grupo ou organização.
As respostas funcionam com todos os tipos de remetente?
As respostas funcionam com números compartilhados ou dedicados. Não suportado com Alpha Tags ou com seu próprio número.
Posso usar um ID de remetente Alpha Tag?
Sim, em países suportados. Limite: 11 caracteres, sem espaços.
Adicione o campo from no corpo do seu JSON:
{
"messages": [
{
"to": "+61411111111",
"from": "MyCompany",
"body": "esta é uma mensagem de teste"
}
]
}
Solução de problemas
Autenticação
Certifique-se de que está usando seu nome de usuário e chave de API do ClickSend, não sua senha.
SMS inbound não está funcionando?
Certifique-se de ter um número dedicado.
Limite as regras do webhook a menos de 10.
Crédito da conta
Certifique-se de que sua conta do ClickSend tenha crédito suficiente. Recarregue aqui.
Envio global
Ative o envio global para os seus países-alvo. Entre em contato com o suporte para obter ajuda.
Formatação de número de telefone
Use o formato internacional (ex., +1XXXXXXXXXX para os EUA).
Campos de mensagem ausentes
Certifique-se de que os campos obrigatórios, como número do destinatário e corpo da mensagem, estejam preenchidos.