Receita de integração

Integração do WhatsApp com Jira: solicitações do Service Management pelo WhatsApp

Guia de configuração e fluxo de trabalho do n8n importávelÚltima verificação: outubro de 2026

O Spun mantém o WhatsApp no número que os seus clientes já usam e o conecta ao Jira Service Management por um fluxo de trabalho no seu próprio n8n. Cada conversa do WhatsApp vira uma solicitação no seu projeto de serviço, as mensagens seguintes entram como comentários, e um comentário público de um agente volta ao cliente no WhatsApp.

Esta é a configuração de WhatsApp para o Jira Service Management, pensada para equipes que já acompanham o suporte no Jira: os agentes continuam trabalhando as solicitações onde já estão, e os clientes continuam mandando mensagens onde já estão. O token de API do Jira fica no seu n8n; o Spun nunca o recebe nem o guarda.

O que o fluxo de trabalho de WhatsApp com Jira Service Management faz

  • A primeira mensagem de uma conversa abre uma solicitação do tipo de solicitação que você escolher, com o nome, o número e a mensagem do cliente na descrição, e o número em um campo de número de WhatsApp.
  • As mensagens seguintes entram na solicitação aberta como comentários públicos, precedidas pelo nome e pelo número de quem enviou.
  • Um comentário público de um agente é enviado ao cliente no WhatsApp como texto. Comentários internos nunca saem do Jira.
  • As respostas que a sua equipe envia pela caixa de entrada do Spun entram como comentários internos, então os dois lados podem responder.
  • Arquivar a conversa no Spun executa a sua transição de resolução, e desarquivar reabre a solicitação quando há uma transição de reabertura definida. Resolver no Jira também pode arquivar a conversa no Spun, uma opção que fica desativada até você ativá-la.

Todas as solicitações são abertas por uma única conta de integração, um agente do projeto de serviço. O fluxo de trabalho não cria nem associa clientes do Jira, então as notificações a clientes do Jira para essas solicitações vão para a caixa de e-mail dessa conta, não para o cliente.

Configuração, passo a passo

Você precisa de um site do Jira Service Management com um projeto de serviço, de uma conta de integração que seja agente nesse projeto (se essa licença é cobrada depende do seu plano do Jira), de um administrador do Jira uma vez para criar o webhook e de uma instância do n8n que o Jira e o Spun consigam acessar por HTTPS.

  1. 1

    Crie um token de API para a conta de integração

    Conectado como essa conta, crie um token de API e guarde-o no n8n como uma credencial “Basic Auth”. Ele fica no seu n8n.

  2. 2

    Adicione um campo “WhatsApp number”

    Um campo de texto curto no tipo de solicitação que as conversas do WhatsApp devem usar.

  3. 3

    Consulte as suas transições

    A transição que resolve uma solicitação e, se quiser, uma que a reabre.

  4. 4

    Importe o fluxo de trabalho

    Abra o nó “Settings” dele e cole a URL do seu site, o service desk, o tipo de solicitação, a chave do projeto, o id do campo, as transições e o id da conta de integração.

  5. 5

    Crie o webhook do Jira

    Como administrador do Jira, um webhook para a URL de resposta do fluxo de trabalho em “Comment: created”, filtrado com JQL para o seu projeto e protegido com um segredo. O Jira assina cada entrega e o fluxo de trabalho confere a assinatura.

  6. 6

    Crie uma chave de API do Spun

    “Configurações”, depois “Webhooks”, depois “Gerenciar Chaves da API”, com o escopo “Send Messages”. Marque também “Fechar e Reabrir Conversas” se resolver no Jira tiver que arquivar a conversa no Spun.

  7. 7

    Assine o fluxo de trabalho aos eventos do Spun

    Adicione um webhook para mensagens recebidas, mensagens enviadas, conversa fechada e conversa reaberta, com o “Formato de Payload” em “Bruto (padrão)”, e cole o segredo de assinatura dele no fluxo de trabalho.

  8. 8

    Envie uma mensagem de teste

    Mande uma mensagem para a linha a partir de outro celular. Uma solicitação aparece no Jira; adicione um comentário público como agente e a resposta chega ao celular.

Relacionado: Documentação: Jira Service Management via n8n, o guia de configuração completo · WhatsApp + n8n: a API e os webhooks por baixo

O que saber antes de montar

  • Chats de grupo são ignorados.
  • As mídias entram na solicitação como um link válido por 24 horas, não como anexo do Jira. As respostas vindas do Jira são só texto; anexos em um comentário não são encaminhados.
  • O Jira aceita 20 gravações em uma mesma solicitação em 2 segundos e 100 em 30 segundos. Durante uma rajada longa de mensagens, as que excedem esse limite não entram na solicitação; elas ficam na caixa de entrada do Spun e a execução do n8n pode ser repetida.
  • Uma solicitação aberta por conversa. Comentários com mais de 32.000 caracteres são cortados.
  • Cada evento entregue usa tokens de IA do seu plano do Spun. A forma de medir isso no uso com help desk ainda está em análise.

Relacionado: Todas as integrações de help desk com WhatsApp · O WhatsApp como o próprio help desk

Perguntas frequentes

O Jira Service Management consegue receber mensagens do WhatsApp?

Sim, pelo Spun e por um fluxo de trabalho do n8n. Cada conversa do WhatsApp vira uma solicitação no seu projeto de serviço, e as mensagens seguintes entram como comentários.

Como os agentes respondem ao WhatsApp pelo Jira?

Com um comentário público na solicitação. Um webhook assinado do Jira o envia ao fluxo de trabalho, que o envia ao cliente no WhatsApp a partir do seu próprio número. Comentários internos ficam no Jira.

As solicitações são abertas em nome do cliente?

Não. Todas as solicitações são abertas por uma única conta de integração, e o nome e o número do cliente são escritos na solicitação. Nenhuma conta de cliente é criada no Jira.

O Spun guarda o meu token de API do Jira?

Não. O token fica nas suas credenciais do n8n. O Spun só vê o lado do WhatsApp e as respostas que o fluxo de trabalho pede para ele enviar.

Isto é um app do marketplace do Jira?

Não. É um fluxo de trabalho do n8n que você importa no seu próprio n8n, Cloud ou auto-hospedado, com um guia de configuração na documentação do Spun.

Conversas do WhatsApp como solicitações do Jira

O Spun transforma o número de WhatsApp que você já tem em uma caixa de entrada compartilhada da equipe, com etiquetas, atribuição e resumos com IA, além dos webhooks e da API que este fluxo de trabalho usa. Teste grátis.

Comece grátis: 7 dias com tudo incluído

Ver todas as integrações