Pular para o conteúdo principal
Mensagens diretas permitem conversas privadas no X. Elas são um dos recursos mais populares do X, com uma ampla variedade de casos de uso — de bate‑papos em grupo entre amigos ao suporte ao cliente para marcas no mundo todo. Novas versões v2 dos endpoints de Mensagens diretas serão introduzidas em etapas, e esta primeira etapa inclui endpoints fundamentais para criar Mensagens diretas e listar eventos de conversas. Pela primeira vez, a X API v2 oferece suporte a conversas em grupo. Esta versão inicial de Manage Direct Messages inclui três métodos POST para criar Mensagens diretas:
  • POST /2/dm_conversations/with/:participant_id/messages - Cria uma Mensagem direta um‑a‑um. Este método cria uma nova conversa 1‑1 ou recupera a conversa atual e adiciona a Mensagem direta a ela. O parâmetro de caminho :participant_id é o id do Usuário da conta que receberá a mensagem.
  • POST /2/dm_conversations - Cria uma nova conversa em grupo e adiciona uma Mensagem direta a ela. Essas solicitações exigem uma lista de participantes da conversa. Observe que é possível criar várias conversas com a mesma lista de participantes. Essas solicitações sempre retornarão um novo id de conversa.
  • POST /2/dm_conversations/:dm_conversation_id/messages - Cria uma Mensagem direta e a adiciona a uma conversa existente. O parâmetro de caminho :dm_conversation_id é o id da conversa à qual a mensagem será adicionada.
Observe que os ids de eventos de Mensagens diretas são comuns entre a v1.1 e a v2 (assim como no X App), portanto, os métodos da v1.1 para ocultar/delete Mensagens diretas podem ser usados junto com este novo endpoint v2. Observe também que as Account Activity APIs Enterprise e Premium oferecem suporte a mensagens um‑a‑um na v2, mas ainda não oferecem suporte a conversas em grupo. Há um limite de taxa por usuário de 200 solicitações por 15 minutos para o método POST. Há também um limite de taxa de 1000 solicitações por 24 horas por usuário. Além disso, há um limite de taxa de 15000 solicitações por 24 horas. Esses limites de requisições são compartilhados entre esses endpoints POST. Como você está fazendo solicitações em nome de um usuário com os endpoints de gerenciamento de Posts, é necessário autenticar com OAuth 1.0a User Context ou OAuth 2.0 Authorization Code with PKCE, e usar um Access Token de usuário associado a um usuário que autorizou sua App. Para gerar esse Access Token de usuário com OAuth 1.0a, você pode usar o fluxo OAuth de 3 etapas. Para gerar um Access Token de usuário com OAuth 2.0, você pode usar o fluxo de concessão Authorization Code com PKCE.
Configuração da contaPara acessar esses endpoints, você precisará de:Saiba mais sobre como obter acesso aos endpoints da X API v2 em nosso guia de primeiros passos.
⌘I