WhatsApp Inbox API: conecte o Inbox do time ao que você já usa

O Inbox agora tem API própria. O que o time faz com as conversas no Shared Inbox passa a ser possível por código: listar, buscar, atribuir, abrir e fechar, bloquear um contato e receber os eventos no webhook. O time segue atendendo no Inbox e vê lá o que o código mudou.

Quem já usa a WhatsApp Business API não mexe nesse lado. Envio, modelos, mensagens recebidas e status de entrega continuam iguais.

WhatsApp Team Inbox API

A WhatsApp Inbox API é a API HTTP do Inbox da 1MSG: conversas, responsáveis, status, histórico e o que acontece com o time. O código opera o Inbox como um operador na Plataforma, e o time vê na hora. Cada ação fica no chat como mensagem de sistema. Os eventos chegam ao seu webhook, assinados.

Para que serve:

• O Inbox dentro do CRM. A fila e o histórico aparecem no cadastro do cliente, e a conversa se acha pelo telefone ou pelo texto da mensagem.
• Distribuição pelas suas regras. A conversa nova já cai para o operador certo, por idioma, região ou perfil do cliente.
• Transbordo do bot. Quando precisa de uma pessoa, o bot passa a conversa para um operador. Quando o assunto se resolve, ele fecha.
• CRM em dia. Os eventos do Inbox atualizam o responsável e o estado de um negócio ou chamado.
• Fila sob controle. As contagens servem para um painel ou um alerta quando as conversas sem responsável começam a juntar.

Apresentamos a 1MSG Platform API

Até aqui, a API da 1MSG era WhatsApp: a WhatsApp Business API e as ferramentas que construímos em cima dela.

A WhatsApp Inbox API é a primeira API da nova Plataforma 1MSG que não é a de um canal de WhatsApp. É a do trabalho do time com as conversas. Tem chaves, documentação e webhook próprios.

Cada API cuida de uma parte. A WhatsApp Business API envia e recebe as mensagens. A Inbox API diz quem atende a conversa, em que estado ela está e o que mudou. A resposta ao cliente continua saindo pela WhatsApp Business API. Mensagens recebidas e status de entrega continuam no webhook do canal.

O Inbox é o primeiro.

Como começar

A WhatsApp Inbox API está na nova Plataforma 1MSG. A chave é de um usuário e vale pelos permisos dele: vê os canais dele e age em nome dele. Para ver todos os canais, o dono da conta cria uma chave para si. Para o código enxergar só o que um colega enxerga, crie a chave desse colega.

A chave vai como token Bearer. Os eventos do Inbox chegam na URL que o dono da conta configurar. Métodos e eventos estão na documentação da WhatsApp Inbox API.