ConnectWiz + Zendesk

Integração em produção

Mantenha o Zendesk a funcionar durante a mudança — sem trabalho a dobrar

Uma ponte pragmática para os meses de transição: os tickets nascidos no ConnectWiz aparecem no Zendesk, as respostas espelham-se nos dois sentidos e uma salvaguarda anti-ciclo torna o clássico pingue-pongue infinito de comentários estruturalmente impossível. Quando a mudança terminar, desligue-a.

Push e pull, independentes Segurança por segredo partilhado Protegida contra ciclos por desenho
Zendesk × ConnectWiz
Ticket → criado no Zendesk
Resposta do agente ← via trigger protegido
Eco marcado — ciclo impossível
2
Sentidos — push e pull — ligados de forma independente, conforme a fase da migração
1
Segredo partilhado no caminho de pull, comparado em tempo constante
0
Ciclos possíveis — as mensagens espelhadas são marcadas na fronteira e os ecos nunca voltam a atravessar
∞
Quanto tempo deve manter dois balcões: nenhum. A ponte foi feita para a transição e depois para a reforma

Suporte

O que faz — ao certo

Push: os tickets saem

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

Pull: as respostas voltam

Um trigger do Zendesk publica os comentários dos agentes na conversa do ConnectWiz — autenticado por um segredo partilhado comparado em tempo constante, com os comentários dos utilizadores finais filtrados.

A salvaguarda anti-ciclo

As mensagens espelhadas são marcadas na fronteira, para que o recetor de push nunca as devolva — a falha que isto evita é o pingue-pongue infinito de comentários em tickets.

Dois interruptores

O push e o pull ativam-se de forma independente — espelhar só para fora, só para dentro, ou ambos, conforme a fase da sua migração.

Por dentro

A mecânica da ponte

Push, com uma espinha de referências

Um ticket do ConnectWiz cria o seu gémeo no Zendesk com assunto, primeiro comentário e uma referência externa que ata o par — cada resposta posterior junta-se como comentário ao mesmo ticket, nunca a um novo.

Pull, através do seu próprio trigger

Um trigger JSON que cola no Zendesk devolve os comentários dos agentes — autenticado pelo segredo partilhado, com os comentários dos utilizadores finais filtrados, para que as palavras do próprio cliente não lhe voltem em eco.

A salvaguarda anti-ciclo, em concreto

Todas as mensagens que atravessam a ponte são marcadas como espelhadas e o recetor de push ignora mensagens marcadas — o pingue-pongue infinito de comentários que assola as pontes ingénuas entre dois balcões é estruturalmente impossível, não apenas improvável.

Os sentidos são independentes

Espelhe só para fora (manter o Zendesk como arquivo), só para dentro (esvaziá-lo) ou ambos (correr em paralelo durante a mudança) — cada sentido tem o seu interruptor, para que a ponte acompanhe a sua migração semana a semana.

Configuração

Como se liga

01

Ligue o seu Zendesk

Subdomínio, e-mail do agente e token de API — encriptados, com um teste de ligação.

02

Cole o trigger

Adicione no Zendesk o trigger JSON fornecido para o sentido de pull.

03

Ligue os sentidos

Ative o push, o pull ou ambos — e desligue-os no dia em que a migração acabar.

Melhor em conjunto

Com o que se combina

A caixa de entrada

Os tickets em ponte são conversas normais da caixa de entrada — encaminhamento, atribuição, relógios de SLA e rascunhos de IA aplicam-se todos enquanto a ponte estiver a correr.

E-mail e tickets

A ponte assenta nas conversas de ticket — os nascidos de e-mail e os nascidos no portal espelham-se da mesma maneira.

A saída

Quando a mudança estiver concluída, desligue os dois sentidos — as conversas, os contactos e o histórico já estão em casa. É esse o objetivo.

Segurança e garantias

As garantias aborrecidas

Credenciais encriptadas e testadas

O subdomínio, o e-mail do agente e o token de API são encriptados em repouso, e a ligação corre um teste real contra o seu Zendesk antes de alguma coisa depender dela.

O caminho de pull é autenticado

As chamadas do trigger de entrada levam o segredo partilhado e são comparadas em tempo constante — um URL adivinhado não chega a escrever na sua caixa de entrada.

Só os comentários dos agentes atravessam

O pull filtra pelos comentários escritos por agentes — o texto dos utilizadores finais, as automações e as notas do sistema ficam do seu lado da ponte.

As letras pequenas, sem rodeios

Limites, declarados

Uma ponte, não um importador

O âmbito é criar tickets e responder, nos dois sentidos. Artigos da central de ajuda, macros, SLAs e vistas não atravessam — o caso de uso honesto é a transição e, depois, a reforma.

Só conversas de ticket

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

FAQ do Zendesk

Respostas diretas

Mais respostas no FAQ, ou pergunte-nos diretamente.

A criação de tickets e as respostas, nos dois sentidos: os tickets do ConnectWiz criam tickets no Zendesk e espelham comentários; as respostas dos agentes do Zendesk voltam através de um trigger protegido. O push e o pull ligam-se de forma independente.

Todas as mensagens espelhadas são marcadas na fronteira e o recetor de push ignora as mensagens marcadas — por isso um comentário atravessa a ponte uma vez e nunca fica a saltar para sempre.

Foi feito para a transição: mantenha os dois balcões em sincronia enquanto a sua equipa muda e depois desligue a ponte. As equipas que querem o Zendesk para sempre normalmente não deviam estar a pagar dois balcões.

Qualquer plano que inclua acesso à API e triggers — a ponte usa um token de API normal e um trigger, sem app do marketplace do Zendesk e sem subscrição do Sunshine.

As respostas de texto espelham-se; o espelhamento de anexos não é prometido. Durante uma migração, o ficheiro costuma viver do lado onde a conversa está de facto a ser trabalhada — a ponte mantém as palavras em sincronia para que nada seja respondido duas vezes.

Ligado com honestidade vale mais do que ligado com alarido.

Cada integração aqui está descrita pelo que faz na realidade — direção, propriedade dos dados e limites incluídos.