Autenticação
Os endpoints de DM exigem autenticação de usuário para acessar conversas 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
MessageCreate
MessageCreate
ParticipantsJoin
ParticipantsJoin
ParticipantsLeave
ParticipantsLeave
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