Integração com o Zapier

O Zapier conecta o Deskwoot a milhares de outros apps sem código. Há dois jeitos de usar. Qual serve depende do seu plano do Deskwoot e de os seus Zaps só reagirem ao Deskwoot ou também mudarem coisas nele.

Qual jeito serve

	App do Deskwoot para o Zapier	Webhooks by Zapier
Plano do Deskwoot	Enterprise	Todos os planos
Entra com	Um token da API REST	Nada: você cola uma URL do Zapier no Deskwoot
Gatilhos	6, com campos prontos	7 eventos em JSON
Ações no Deskwoot	Sim	Não, os eventos só saem
Plano do Zapier	Depende dos seus Zaps	Um plano pago, porque o Webhooks by Zapier é um app premium do Zapier

O app do Deskwoot para o Zapier (Enterprise)

1. No Deskwoot, vá em Configurações > Tokens de API e crie um token, por exemplo chamado Zapier, com os escopos Leitura e Escrita. Copie o token; ele aparece só uma vez. Crie como administrador: só o token de um administrador consegue ativar gatilhos do Deskwoot.
2. Vá em Configurações > Integrações, clique em Conectar no card Zapier (Gerenciar, se o Webhooks by Zapier já estiver conectado) e clique em Abrir o app do Deskwoot no Zapier.
3. No Zapier, adicione um gatilho ou uma ação do Deskwoot a um Zap. Quando o Zapier pedir para conectar uma conta, cole o token de API. O Zapier dá à conexão o nome do seu workspace do Deskwoot e do seu e-mail.

Abaixo do Enterprise, o card do app do Deskwoot na página do Zapier mostra Bloqueado no seu plano, e Configurações > Tokens de API também fica bloqueado. O teste de 7 dias não libera. Use o Webhooks by Zapier (abaixo) ou clique em Fazer upgrade para o Enterprise.

Gatilhos

• New Conversation (Nova conversa): uma conversa começa, seja porque um cliente escreveu ou porque sua equipe iniciou.
• New Customer Message (Nova mensagem de cliente): um cliente escreve em uma conversa. Respostas e notas da sua equipe não contam.
• Conversation Assigned (Conversa atribuída): uma conversa ganha um novo responsável. O rodízio (round robin) de uma conversa nova e as regras de automação não disparam esse gatilho.
• Conversation Resolved (Conversa resolvida): uma conversa é marcada como resolvida.
• New Contact (Novo contato): um colega adiciona um contato no Deskwoot, ou um app adiciona um pela API. Contatos que o Deskwoot cria a partir de mensagens recebidas não disparam; para esses, use New Conversation.
• New CSAT Rating (Avaliação CSAT): um cliente avalia uma conversa.

Cada gatilho entrega ao Zapier um registro com campos simples. Uma conversa vem com número, link, status, assunto, canal, caixa de entrada, responsável, equipe, etiquetas, nome, e-mail e telefone do cliente e a primeira mensagem dele. Enquanto você monta o Zap, o Zapier mostra seus registros mais recentes como exemplos.

Ações

• Start Conversation (iniciar conversa): envia uma primeira mensagem a um contato a partir de uma das suas caixas de entrada. O Deskwoot acha o contato pelo e-mail, pelo telefone ou pelo Contact ID. Serve para canais em que uma empresa pode escrever primeiro, como e-mail ou SMS. No WhatsApp só funciona dentro de 24 horas da última mensagem do cliente para aquela caixa de entrada, porque a ação não envia modelo; senão o Deskwoot recusa e o Zap mostra o motivo.
• Reply in Conversation (Responder na conversa): envia uma resposta ao cliente pelo canal da conversa.
• Add Private Note (Adicionar nota privada): adiciona uma nota que só sua equipe vê.
• Assign Conversation (Atribuir conversa): a um colega, a uma equipe ou aos dois.
• Add Label (Adicionar etiqueta): aplica uma das suas etiquetas a uma conversa.
• Find Contact (Encontrar contato): procura um contato por e-mail, telefone ou nome.
• Create or Update Contact (Criar ou atualizar contato): atualiza o contato com aquele e-mail, ou cria quando não existe.

Respostas e notas vindas do Zapier aparecem com o nome da pessoa que criou o token de API.

Webhooks by Zapier (todos os planos)

1. No Zapier, crie um Zap com o gatilho Webhooks by Zapier e o evento Catch Hook, e copie a URL que o Zapier mostra.
2. No Deskwoot, vá em Configurações > Integrações, clique em Conectar no card Zapier, cole a URL em URL do webhook, clique em Testar conexão e depois em Conectar.
3. De volta ao Zapier, teste o gatilho e adicione os próximos passos.

O Deskwoot então envia 7 eventos para essa URL: nova conversa, nova mensagem, conversa atribuída, conversa resolvida, novo contato, contato atualizado e avaliação CSAT enviada. Cada um chega como JSON com os campos event, timestamp, account_id e data, então um Zap filtra pelo campo event para reagir a um deles. Esse caminho só envia dados para fora: um Zap não muda nada no Deskwoot por ele. O Webhooks by Zapier é um app premium no Zapier, então precisa de um plano pago do Zapier.

Perguntas frequentes

Qual jeito devo usar?

No Enterprise, o app do Deskwoot: os gatilhos vêm com campos prontos e as ações gravam de volta no Deskwoot. Em qualquer outro plano, o Webhooks by Zapier, que só envia eventos.

Por que o Zapier diz que a API REST precisa do plano Enterprise?

O app do Deskwoot para o Zapier entra com um token da API REST, e a API REST faz parte do plano Enterprise. Faça upgrade em Configurações > Cobrança ou use o Webhooks by Zapier, que funciona em todos os planos.

Por que não consigo ativar um Zap com gatilho do Deskwoot?

Só um token de API criado por um administrador consegue ativar gatilhos do Deskwoot, porque um gatilho recebe os eventos de todas as conversas, como um webhook. Conecte a conta do Deskwoot de novo no Zapier com o token de um administrador.

O que acontece se eu revogar o token?

Todos os gatilhos que aquele token ativou param na hora, e as ações dos Zaps falham com erro de login. Crie um novo token e conecte a conta do Deskwoot de novo no Zapier.

O Zapier pode responder aos clientes?

Sim, com o app do Deskwoot no Enterprise: Reply in Conversation envia a mensagem pelo canal da conversa. O Webhooks by Zapier não muda nada no Deskwoot.

Os dados dos clientes ficam seguros no Zapier?

O Zapier declara estar em conformidade com o GDPR e ter o SOC 2, mas os dados passam pelos servidores do Zapier, também fora da UE. Para um fluxo de dados só na UE, envie os eventos para o seu próprio endpoint com os webhooks do Deskwoot.