Ir para o conteúdo
OmniChannels.ai

Atendimento

Zendesk + OmniChannels.ai: envie mensagens a clientes quando os tickets mudam

Conexão via API e webhooksAtualizado em

Em resumo

O Zendesk pode chamar a REST API da OmniChannels.ai pelos próprios webhooks: um gatilho dispara quando um ticket muda e envia uma requisição JSON com o seu token Bearer, o que atende ao nosso endpoint de SMS individual. Envios de WhatsApp e de outros canais, e as respostas dos clientes que voltam aos tickets, normalmente passam por uma ferramenta de automação como n8n, Make ou Zapier. Não existe app no marketplace.

O que você pode fazer

  • Confirmação de ticket recebido

    Quando um ticket é criado a partir de um canal baseado em telefone, um gatilho envia um SMS com o número do ticket para que o cliente saiba que ele foi registrado.

  • Atualizações de mudança de status

    Quando um agente define um ticket como pendente ou resolvido, um gatilho envia ao cliente uma atualização curta por SMS com um link para o ticket.

  • Escalonamento de tickets urgentes

    Quando um ticket é marcado como urgente, avise o gerente de plantão por SMS para que ele seja tratado fora do horário comercial.

  • Acompanhamentos por WhatsApp com modelos

    Um gatilho chama uma ferramenta de automação, que envia um modelo de WhatsApp aprovado, em árabe ou inglês, pela nossa API.

  • Respostas de volta aos tickets

    Respostas recebidas por SMS ou WhatsApp chegam a uma ferramenta de automação pelo nosso webhook, que as adiciona como comentários no ticket correspondente.

Como a conexão funciona

Conexão via API e webhooks

Os webhooks do Zendesk enviam uma requisição HTTP para qualquer URL, com autenticação por bearer token e um corpo JSON montado com placeholders do ticket. Um gatilho ou automação que use o webhook como ação pode chamar https://api.broadnet.me/sms/sendSms diretamente, porque o SMS individual recebe um corpo JSON. Envios em massa e a maioria dos outros canais, incluindo o WhatsApp, usam multipart/form-data, então nesses casos aponte o webhook para uma ferramenta de automação ou uma pequena função sua que chame nossa API.

Nossa plataforma envia os status de entrega e as mensagens recebidas para a única URL de webhook configurada na sua conta. Esse payload não está no formato do Zendesk, então uma ferramenta de automação ou o seu próprio código o recebe, localiza o ticket pelo número de telefone ou pelo ID da mensagem e adiciona um comentário ou atualiza um campo pela API do Zendesk.

  • Webhook do Zendesk: POST para https://api.broadnet.me/sms/sendSms com corpo JSON
  • Autenticação: bearer token nas configurações do webhook, armazenado pelo Zendesk
  • WhatsApp e envios multipart: via n8n, Make, Zapier ou seu próprio código
  • Respostas e status de entrega: nosso webhook e, em seguida, uma automação no Zendesk

Configuração

  1. 1

    Solicitar acesso à API

    Solicite acesso de teste e receba um token de API. Os envios de teste vão apenas para os seus próprios números verificados.

    Guia: Authentication
  2. 2

    Criar um webhook no Zendesk

    No Admin Center do Zendesk, crie um webhook que possa ser usado por um gatilho, com o método POST, formato JSON, a URL de sendSms e autenticação por bearer token.

    Guia: SMS API
  3. 3

    Montar o gatilho

    Adicione um gatilho com as condições do ticket e o webhook como ação, e escreva um corpo JSON com senderId, destinationNumber, message e messageType, usando placeholders do ticket para o número e o texto.

  4. 4

    Encaminhar outros canais

    Para modelos de WhatsApp, aponte o webhook para uma ferramenta de automação e deixe que ela faça a requisição multipart à nossa API.

    Guia: Make and Zapier with webhooks
  5. 5

    Trazer as respostas de volta

    Peça à nossa equipe que configure o webhook da sua conta para a URL de uma ferramenta de automação que adicione as mensagens recebidas e as falhas ao ticket correspondente.

    Guia: Webhooks and delivery statuses
  6. 6

    Testar com o seu número

    Atualize um ticket de teste com o seu número verificado e confira se a mensagem chega e se o status volta.

Documentação do fornecedor

Zendesk é uma marca de seu proprietário. A OmniChannels.ai não é afiliada nem endossada por Zendesk; esta página descreve uma conexão feita com os recursos de MCP, HTTP ou webhook do próprio Zendesk.

Fluxo de exemplo

Como uma solicitação típica vai de Zendesk até o seu cliente e volta.

  1. 01

    Gatilho do Zendesk

    Um ticket é criado ou o status dele muda

  2. 02

    Webhook do Zendesk

    Requisição JSON com o seu token Bearer

  3. 03

    API da OmniChannels.ai

    SMS individual enviado; outros canais via automação

  4. 04

    Celular do cliente

    Atualização do ticket entregue por SMS ou WhatsApp

  5. 05

    Respostas nos tickets

    Mensagens recebidas e falhas viram comentários no ticket

1. Gatilho do Zendesk: Um ticket é criado ou o status dele muda 2. Webhook do Zendesk: Requisição JSON com o seu token Bearer 3. API da OmniChannels.ai: SMS individual enviado; outros canais via automação 4. Celular do cliente: Atualização do ticket entregue por SMS ou WhatsApp 5. Respostas nos tickets: Mensagens recebidas e falhas viram comentários no ticket

Perguntas

Existe um app oficial da OmniChannels.ai no Zendesk Marketplace?

Não. A conexão usa os próprios webhooks e gatilhos do Zendesk para chamar nossa REST API, além de uma ferramenta de automação ou do seu próprio código para outros canais e para as respostas.

Um webhook do Zendesk consegue enviar mensagens de WhatsApp diretamente?

O SMS individual recebe um corpo JSON, que um webhook do Zendesk consegue enviar. O WhatsApp e a maioria dos outros canais usam multipart/form-data, então encaminhe esses envios por uma ferramenta de automação ou uma pequena função que chame nossa API.

Como as respostas dos clientes chegam ao ticket?

As mensagens recebidas são enviadas para a URL de webhook configurada na sua conta. Aponte-a para uma ferramenta de automação que encontre o ticket pelo número de telefone e adicione a resposta como comentário pela API do Zendesk.

Atualizações por WhatsApp precisam de modelos aprovados?

Sim. Fora da janela de atendimento de 24 horas, mensagens de WhatsApp iniciadas pela empresa precisam usar modelos aprovados. Envie apenas para clientes que concordaram em receber atualizações nesse canal.

Obtenha acesso à API e ao MCP

Conte quais canais, países e caso de uso você tem. Um engenheiro emite suas credenciais de teste e verifica seus números de teste.