Integração com o Twitter / X

Atualizado em 20 de out. de 20265 min de leitura
Português
Nesta página

Conecta sua conta Twitter/X pra tratar Direct Messages do Deskwoot. Cria um app no X Developer Portal, cola as chaves dele no Deskwoot e registra a URL de webhook. DMs de entrada caem como conversas; agentes respondem do Deskwoot, cliente ganha a resposta via Twitter. Public mentions e tweets NÃO são sincronizados (integração DM-only). Útil pra marcas onde clientes preferem X pro suporte.

A integração com o Twitter (X) no Deskwoot traz as mensagens diretas para a sua caixa de entrada compartilhada, para que a mesma equipe responda às DMs do X junto com e-mail e chat, sem nunca abrir o twitter.com. Em vez de alternar entre plataformas, sua equipe pode responder às DMs dos clientes direto do Deskwoot, mantendo as conversas organizadas e os tempos de resposta baixos.

Conectando sua conta do Twitter (X) ao Deskwoot

Siga estes passos para vincular sua conta do Twitter:

  1. No X Developer Portal, abra o seu app e vá até Keys and tokens. Você vai precisar da API Key e do API Secret, de um Access Token e do Access Token Secret, e do Bearer Token.
  2. No Deskwoot, acesse Configurações > Caixas de entrada > Adicionar caixa de entrada.
  3. Selecione X na lista de canais disponíveis.
  4. Informe o Nome da caixa de entrada e preencha API Key, API Secret, Access Token, Access Token Secret, Bearer Token e Seu X User ID (o ID numérico da conta do X que recebe as DMs).
  5. Copie a URL de webhook exibida no formulário e defina-a como URL de webhook do Account Activity no X Developer Portal.
  6. Clique em Criar caixa de entrada. As Mensagens Diretas para a sua conta do X passam a chegar nessa caixa de entrada.

Como funciona

Quando alguém envia uma Mensagem Direta para a sua conta conectada do Twitter, ela aparece automaticamente como uma nova conversa no Deskwoot. Sua equipe pode então responder, atribuir a conversa a agentes específicos, adicionar notas internas e usar todos os recursos padrão da caixa de entrada do Deskwoot, assim como faria com qualquer outro canal.

Solução de problemas e erros comuns

  • Nenhuma mensagem chega: Verifique se a URL de webhook do formulário está definida como URL de webhook do Account Activity no X Developer Portal e se Seu X User ID é o ID numérico da conta que recebe as DMs.
  • Algumas mensagens não aparecem: Confirme que a mensagem do remetente é uma Mensagem Direta, já que menções e respostas públicas não são trazidas para a caixa de entrada.
  • Conta desconectada: O Twitter pode revogar o acesso do app se você mudar a senha ou ajustar as permissões do app no lado do Twitter. Se isso acontecer, gere novas chaves e tokens no X Developer Portal, exclua a caixa de entrada no Deskwoot e conecte de novo usando os passos acima. Não é possível trocar as chaves de uma caixa de entrada existente.

Dicas de boas práticas

  • Permita DMs de qualquer pessoa: Nas configurações da sua conta do Twitter, permita Mensagens Diretas de todos os usuários (não só dos seguidores), para que os clientes possam falar com você sem precisar seguir a sua conta primeiro.
  • Use regras de atribuição: Configure atribuição por equipe ou roteamento round robin no Deskwoot para garantir que as DMs do Twitter sejam atendidas rapidamente pelos agentes certos.
  • Seja direto nas respostas: As DMs do Twitter aceitam textos mais longos do que os tweets, mas, na plataforma, os clientes geralmente esperam respostas rápidas e objetivas.

Perguntas frequentes

Tweets públicos são importados?
Não, só DMs. Public mentions, replies, retweets: nenhum sincroniza. Se precisa de monitoramento de public mention, usa ferramenta separada tipo Brand24 ou Mention.
Posso mandar Twitter DM pra user que não me mandou mensagem?
Não. O botão de nova mensagem do Deskwoot não oferece o X, então não dá pra iniciar uma DM nova pelo Deskwoot. Você responde às DMs que os clientes te mandam.
E se meu acesso Twitter for revogado?
Acontece quando você muda senha do X ou revoga permissões de app. A inbox para de funcionar. Configurações → Caixas de entrada → exclui a inbox quebrada e cria uma nova inbox X com chaves novas do X Developer Portal.
Posso conectar várias contas Twitter?
Sim. Cada conta Twitter vira inbox separada. Útil pra empresas multi-marca com contas X diferentes por marca.
O bot responde DMs do X?
Sim, quando ativado. O Fynn responde DMs do X como em qualquer outro canal: detecta o idioma e responde com base nas suas fontes de conhecimento. Acima da primeira resposta dele, o cliente vê uma linha como "Fynn, o assistente de IA de Acme". Útil fora do horário de atendimento, quando as DMs ficariam esperando.
E sobre mídia em DMs?
O texto das DMs recebidas aparece na conversa. Imagens e vídeos de uma DM não são exibidos; uma DM só com mídia aparece como um marcador curto. Arquivos que você anexa a uma resposta vão como link de download no texto da DM, válido por 7 dias.
Tem limite de tamanho de DM?
Sim, 10.000 caracteres por DM (bem maior que 280 do tweet). Maioria dos times mantém DMs curtos já que clientes esperam replies rápidos estilo X.
A integração usa API Twitter v1 ou v2?
As respostas saem pela API v2 do X. As DMs recebidas chegam ao Deskwoot pelo webhook do Account Activity API que você configura no X Developer Portal.
Respostas do cliente a replies do bot voltam pro Deskwoot?
Sim. A thread DM persiste; mensagens subsequentes do cliente threadeiam na mesma conversa no Deskwoot. Bot ou agente pode pegar o próximo turno.
E se Twitter (X) restringe acesso free à API ainda mais?
Dependendo das mudanças de tier de API do Twitter, alguns features podem precisar de conta Twitter Developer paga. Atualizamos o guia de integração quando policy muda; confere a central de ajuda pra última.
Posso ver analytics DM em Reports?
Em parte. Relatórios não têm filtro por inbox, mas a tabela Tempo médio de resposta por canal mostra cada inbox com as conversas e o tempo médio da primeira resposta, então sua inbox do X tem uma linha própria.
O que acontece se eu desconectar a caixa de entrada do Twitter?
As conversas existentes permanecem no Deskwoot para consulta, mas nenhuma nova Mensagem Direta será recebida. Você pode conectar a conta de novo a qualquer momento como uma nova caixa de entrada.

Este guia foi útil?

Continue lendo

Perguntar ao Fynn sobre este guia

Receba uma resposta curta deste guia e do resto da Central de Ajuda.

Ainda precisa de ajuda?

Fynn responde no chat a partir destes guias, e você também fala com a equipe por lá.

Enviar e-mail