Autenticação
Os endpoints de DM exigem autenticação de usuário: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: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
Não é possível enviar para o usuário
Não é possível enviar para o usuário
O destinatário pode ter configurações de DM que impedem mensagens de usuários desconhecidos, ou pode tê-lo bloqueado.
Falha no anexo de mídia
Falha no anexo de mídia
Certifique-se de que a mídia foi enviada pelo mesmo usuário autenticado e tem menos de 24 horas.
Falha na criação do grupo
Falha na criação do grupo
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