Skip to main content
Este guia aborda os conceitos-chave necessários para integrar os endpoints de gerenciamento de Mensagens Diretas em sua aplicação.

Autenticação

Os endpoints de DM exigem autenticação de usuário:
A autenticação App-Only não é suportada. Todas as Mensagens Diretas são privadas.

Escopos necessários (OAuth 2.0)


Visão geral dos endpoints


Enviando mensagens

Mensagem individual

Envie uma mensagem para um usuário específico. Cria uma nova conversa se ainda não existir:
cURL

Conversa em grupo

Crie um novo grupo e envie a primeira mensagem:
cURL
O campo conversation_type deve ser definido como "Group" (diferencia maiúsculas de minúsculas).

Adicionar a uma conversa existente

Envie uma mensagem para qualquer conversa da qual você faça parte:
cURL

Anexos de mídia

Anexe uma peça de mídia (foto, vídeo ou GIF) por mensagem.
1

Faça upload da mídia

Use o endpoint de Media Upload para enviar seu arquivo e obter um media_id.
2

Inclua na mensagem

  • O usuário autenticado deve ter enviado a mídia
  • A mídia fica disponível por 24 horas após o upload
  • Apenas um anexo por mensagem é suportado

Compartilhando posts

Inclua um Post na sua mensagem adicionando a URL do Post ao texto:
A resposta incluirá um campo referenced_tweets com o ID do Post.

Requisitos da mensagem

*Pelo menos um entre text ou attachments deve ser fornecido.

Compatibilidade de IDs com a v1.1

Os IDs de conversa e evento são compartilhados entre os endpoints v1.1 e v2. Isso possibilita fluxos híbridos:
  • Criar mensagens com a v2
  • Excluir mensagens com a v1.1 (ainda não disponível na v2)
  • Referenciar IDs de conversa das URLs do x.com

Tratamento de erros

Problemas comuns

O destinatário pode ter configurações de DM que impedem mensagens de usuários desconhecidos, ou pode tê-lo bloqueado.
Certifique-se de que a mídia foi enviada pelo mesmo usuário autenticado e tem menos de 24 horas.
Verifique se todos os IDs de participantes são válidos e se os usuários permitem convites de DM em grupo.

Próximos passos

Quickstart

Envie sua primeira Mensagem Direta

Consulta de DM

Recupere conversas de DM

Upload de mídia

Faça upload de mídia para anexos

Referência da API

Documentação completa do endpoint