ConnectWiz + Zendesk

Integração no ar

Mantenha o Zendesk rodando durante a mudança — sem trabalho dobrado

Uma ponte pragmática para os meses de transição: os tickets que nascem no ConnectWiz aparecem no Zendesk, as respostas são espelhadas nos dois sentidos, e uma trava anti-loop torna estruturalmente impossível o clássico pingue-pongue infinito de comentários. Quando a mudança terminar, é só desligar.

Push e pull, independentes Segurança por segredo compartilhado Protegida contra loop desde o projeto
Zendesk × ConnectWiz
Ticket → criado no Zendesk
Resposta do atendente ← por gatilho protegido
Eco marcado — loop impossível
2
Direções — push e pull — ligadas e desligadas de forma independente, conforme a fase da migração
1
Segredo compartilhado no caminho de pull, comparado em tempo constante
0
Loops possíveis — as mensagens espelhadas são marcadas na fronteira, e os ecos nunca voltam a cruzar
∞
Quanto tempo você deveria manter duas centrais de atendimento: nenhum. A ponte foi feita para a transição e depois para a aposentadoria

Suporte

O que faz, exatamente

Push: os tickets saem

Uma conversa de ticket do ConnectWiz cria um ticket no Zendesk com assunto, comentário e referência externa; as respostas seguintes entram como comentários.

Pull: as respostas voltam

Um gatilho do Zendesk publica os comentários do atendente dentro da conversa do ConnectWiz — autenticado por um segredo compartilhado comparado em tempo constante, com os comentários do usuário final filtrados fora.

A trava anti-loop

As mensagens espelhadas são marcadas na fronteira, para que o ouvinte de push nunca as mande de volta — o modo de falha que isso evita é o pingue-pongue infinito de comentários de ticket.

Duas chaves

Push e pull ligam de forma independente — espelhe só para fora, só para dentro, ou nos dois sentidos, conforme a fase da sua migração.

Por dentro

A mecânica da ponte

Push, amarrado por referência

Um ticket do ConnectWiz cria o gêmeo dele no Zendesk com assunto, primeiro comentário e uma referência externa amarrando os dois — toda resposta posterior entra como comentário no mesmo ticket, nunca em um novo.

Pull, pelo seu próprio gatilho

Um gatilho JSON que você cola no Zendesk devolve os comentários do atendente — autenticado pelo segredo compartilhado, com os comentários do usuário final filtrados fora, para que as palavras do próprio cliente não voltem ecoando para ele.

A trava anti-loop, na prática

Toda mensagem que cruza a ponte é marcada como espelhada, e o ouvinte de push ignora mensagens marcadas — o pingue-pongue infinito de comentários que assombra as pontes ingênuas entre duas centrais é estruturalmente impossível, não apenas improvável.

As direções se desacoplam

Espelhe só para fora (mantendo o Zendesk como arquivo), só para dentro (esvaziando ele) ou nos dois sentidos (rodando em paralelo durante a mudança) — cada direção tem a própria chave, então a ponte acompanha sua migração semana a semana.

Configuração

Como se conecta

01

Conecte seu Zendesk

Subdomínio, e-mail do atendente e token de API — criptografados, com um teste de conexão.

02

Cole o gatilho

Adicione no Zendesk o gatilho JSON fornecido, para a direção de pull.

03

Ligue as direções

Habilite push, pull ou os dois — e desligue no dia em que a migração terminar.

Melhor em conjunto

Com o que se combina

A caixa de entrada

Os tickets que passam pela ponte são conversas comuns da caixa de entrada — roteamento, atribuição, relógios de SLA e rascunhos de IA valem todos enquanto a ponte estiver rodando.

E-mail e tickets

A ponte anda sobre as conversas de ticket — os tickets nascidos de e-mail e os nascidos no portal espelham do mesmo jeito.

A saída

Quando a mudança terminar, desligue as duas direções — conversas, contatos e histórico já estão em casa. É esse o ponto.

Segurança e garantias

As garantias chatas

Credenciais criptografadas e testadas

Subdomínio, e-mail do atendente e token de API ficam criptografados em repouso, e a conexão roda um teste ao vivo contra o seu Zendesk antes de qualquer coisa depender dele.

O caminho de pull é autenticado

As chamadas do gatilho de entrada carregam o segredo compartilhado e são comparadas em tempo constante — uma URL adivinhada não consegue escrever na sua caixa de entrada.

Só os comentários do atendente passam para o outro lado

O pull filtra só os comentários escritos por atendentes — texto de usuário final, automações e notas de sistema ficam do lado de lá da ponte.

As letras miúdas, sem rodeios

Limites, com todas as letras

Uma ponte, não um importador

O escopo é criar e responder tickets, nos dois sentidos. Artigos de central de ajuda, macros, SLAs e visualizações não atravessam — o caso de uso honesto é transição e depois aposentadoria.

Só conversas de ticket

O push dispara para as conversas de ticket do ConnectWiz — um chat de WhatsApp não cria ticket no Zendesk automaticamente, de propósito.

FAQ do Zendesk

Respostas diretas

Mais respostas no FAQ, ou pergunte direto para a gente.

Criação de ticket e respostas, nos dois sentidos: os tickets do ConnectWiz criam tickets no Zendesk e espelham os comentários; as respostas dos atendentes no Zendesk voltam por um gatilho protegido. Push e pull ligam de forma independente.

Toda mensagem espelhada é marcada na fronteira, e o ouvinte de push ignora mensagens marcadas — então um comentário cruza a ponte uma vez e nunca fica quicando para sempre.

Foi feito para a transição: rode as duas centrais em sincronia enquanto sua equipe se muda e depois desligue a ponte. Quem quer o Zendesk para sempre normalmente não deveria estar pagando por duas centrais.

Qualquer plano que inclua acesso à API e gatilhos — a ponte usa um token de API padrão e um gatilho, sem app do marketplace do Zendesk e sem assinatura do Sunshine.

As respostas de texto espelham; espelhamento de anexo não é prometido. Durante uma migração, o arquivo normalmente mora no lado em que a conversa está sendo de fato trabalhada — a ponte mantém as palavras em sincronia para que nada seja respondido duas vezes.

Conectado com honestidade vale mais do que conectado com estardalhaço.

Cada integração aqui está descrita pelo que ela realmente faz — direção, propriedade dos dados e limites inclusos.