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

Autenticação

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

Escopos necessários (OAuth 2.0)


Tipos de conversa

Individual

Sempre tem exatamente dois participantes. Formato do ID de conversa: {smaller_user_id}-{larger_user_id}

Grupo

Dois ou mais participantes. A composição pode mudar ao longo do tempo.

Tipos de eventos

Exemplos de eventos


Fields e expansions

Campos padrão

Campos disponíveis

Expansions disponíveis

Exemplo com expansions

cURL

Paginação

Os eventos de DM são retornados em ordem cronológica reversa (mais recentes primeiro):
cURL
Eventos de até 30 dias atrás estão disponíveis.

Compatibilidade de IDs com a v1.1

Os IDs de conversa e evento são compartilhados entre os endpoints v1.1 e v2. Isso significa que você pode:
  • Usar a v2 para recuperar eventos e, em seguida, usar a v1.1 para excluir mensagens específicas
  • Referenciar IDs de conversa das URLs do x.com em solicitações da API

Próximos passos

Quickstart

Faça sua primeira solicitação de consulta de DM

Enviar DMs

Envie Mensagens Diretas

Referência da API

Documentação completa do endpoint

Código de exemplo

Exemplos de código funcionais