Inbox
A caixa de entrada compartilhada: conversas, mensagens e respostas, no mesmo lugar em que a equipe atende pelo painel. Serve para ligar um helpdesk ou um bot externo. Uma API key restrita a alguns números só vê as conversas desses números.
GETEventos da inbox em tempo realUm stream Server-Sent Events com o que acontece na inbox: mensagem nova, status de mensagem, conversa atualizada, alguém digitando. Os eventos avisam o quê…GETListar conversasAs conversas, da mais recente à mais antiga, paginadas por cursor: mande o nextCursor da resposta em cursor para a próxima página. folder escolhe a pasta do…GETContagem das pastasContagem das pastasGETConsultar uma conversaA conversa com o contato completo e as últimas campanhas que ele recebeu.PATCHAtualizar uma conversaMuda o status (fechar, reabrir, deixar pendente, adiar até snoozedUntil), atribui a alguém da equipe ou pausa as automações por 30 dias. Cada mudança vira…GETMensagens de uma conversaDa mais recente à mais antiga, com notas internas e eventos (atribuição, fechamento) misturados às mensagens. Para páginas anteriores, mande o nextCursor em…POSTResponder numa conversaManda uma mensagem pelo número da conversa, escolhida por kind:POSTMarcar conversa como lidaZera o contador de não lidas e, se a conta envia confirmação de leitura, marca a última mensagem do cliente como lida no WhatsApp.POSTMostrar indicador de digitaçãoMostra o indicador de digitação para o cliente, com a janela aberta e as confirmações de leitura ligadas. No máximo uma vez a cada 20 segundos por conversa.POSTSubir arquivo para uma conversaEnvie os bytes do arquivo no corpo (não é multipart), com o nome em X-File-Name. O tipo é detectado pelo conteúdo: imagem (JPEG, PNG), figurinha (WebP),…GETLink de um arquivo da inboxUm link temporário para baixar um arquivo de mensagem, recebido ou enviado. Vale por 5 minutos; peça outro quando expirar.POSTLinks de vários arquivos da inboxOs mesmos links de GET /inbox/media/{id}/url, para até 100 arquivos numa requisição só — use ao abrir uma conversa com muitas mídias, em vez de pedir um…GETPessoas da equipeQuem pode receber conversas — é daqui que sai o assignedUserId. Com phoneNumberId, só quem atende esse número.