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 ticket
Use ao trabalhar em um ticket com um número de telefone salvo.
Ideal para respostas de atendimento ao cliente dentro de conversas.
3. Barra de navegação (Envio de mensagens em massa)
Enviar SMS individuais ou em massa para grupos ou organizações.
Ótimo para anúncios, promoções ou alertas.
Recebendo SMS de entrada
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 de entrada. Saiba mais sobre as Regras de entrada.
Dica: Verifique regularmente seu painel para garantir respostas oportunas.
SMS automatizado via Webhook + Gatilhos
Use os gatilhos do Zendesk para enviar SMS automaticamente quando ocorrerem atualizações no ticket.
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 endpoint: 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 Gatilho
Acesse Gatilhos > Adicionar gatilho.
Escolha uma categoria (ex., Tickets).
Adicione uma ação:
Notificar webhook ativo → selecione seu webhook do ClickSend.
Adicione isso ao corpo do JSON:
Básico:
{
"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 compatível com ID alfanumérico de remetente ou com seu próprio número.
Posso usar um ID alfanumérico de remetente?
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 de entrada 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.