All-in-One Messenger Hub
Guia de integração da API
Conecte seu CRM, sistema de agendamento ou qualquer aplicativo para enviar mensagens do WhatsApp pela nossa API simples.
Comece em 5 passos simples
Baixe o app de desktop
Baixe e instale o All-in-One Messenger Hub no seu computador com Windows.
Conecte seu WhatsApp
Adicione sua conta de WhatsApp ao app escaneando o QR code.
Crie uma Session API
Vá até a aba do WhatsApp e crie uma nova Session API. Vincule-a ao seu canal do WhatsApp.
Copie sua chave de API
Copie a chave de API gerada. Mantenha-a em segurança - ela é sua autenticação.
Comece a enviar mensagens
Use a API a partir do seu aplicativo. Mantenha o app de desktop em execução para entregar as mensagens.
Autenticação
Todos os endpoints da API exigem autenticação por meio da sua chave de API. Você pode passar a chave de qualquer uma destas formas:
| Método | Exemplo |
|---|---|
| Cabeçalho X-API-Key (recomendado) | X-API-Key: sua-chave-de-api |
| Parâmetro de query/corpo | key=sua-chave-de-api |
| Parâmetro alternativo | api_key=sua-chave-de-api |
Enviar mensagem
Envie uma mensagem do WhatsApp para um número de telefone ou grupo. As mensagens são enfileiradas e entregues quando o app de desktop estiver em execução.
POST https://onemessengerhub.com/api/whatsapp-session/sendParâmetros
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
key |
string | Sim | Sua chave de API do app de desktop |
mobile |
string | Condicional | Número de telefone com código do país (obrigatório sem group_id) |
group_id |
string | Condicional | ID do grupo do WhatsApp (obrigatório sem mobile). O sufixo @g.us é adicionado automaticamente. |
message |
string | Sim | Texto da mensagem (máximo de 4096 caracteres) |
Exemplo de requisição
curl -X POST https://onemessengerhub.com/api/whatsapp-session/send \ -H "X-API-Key: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"mobile": "1234567890", "message": "Hello!"}'Requisição GET simples (navegador ou link)
https://onemessengerhub.com/api/whatsapp-session/send?key=YOUR_API_KEY&mobile=1234567890&message=Hello!Resposta de sucesso (201)
{ "success": true, "message": "Message queued successfully", "data": { "message_id": 123, "recipient": "1234567890", "status": "pending" }}Salvar contato
Salve ou renomeie um contato no seu WhatsApp. A operação é enfileirada e processada pelo app de desktop.
POST https://onemessengerhub.com/api/whatsapp-session/save-contactParâmetros
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
key |
string | Sim | Sua chave de API do app de desktop |
contact_id |
string | Sim | Número de telefone ou ID do WhatsApp do contato (máximo de 50 caracteres). O sufixo @c.us é adicionado automaticamente. |
name |
string | Sim | Nome de exibição do contato (máximo de 255 caracteres) |
Exemplo de requisição
curl -X POST https://onemessengerhub.com/api/whatsapp-session/save-contact \ -H "X-API-Key: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"contact_id": "1234567890", "name": "John Doe"}'Resposta de sucesso (201)
{ "success": true, "message": "Contact save operation queued", "data": { "operation_id": 456, "contact_id": "[email protected]", "status": "pending" }}Remover contato
Remova um contato do seu WhatsApp. A operação é enfileirada e processada pelo app de desktop.
POST https://onemessengerhub.com/api/whatsapp-session/remove-contactParâmetros
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
key |
string | Sim | Sua chave de API do app de desktop |
contact_id |
string | Sim | Número de telefone ou ID do WhatsApp do contato (máximo de 50 caracteres). O sufixo @c.us é adicionado automaticamente. |
Exemplo de requisição
curl -X POST https://onemessengerhub.com/api/whatsapp-session/remove-contact \ -H "X-API-Key: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"contact_id": "1234567890"}'Resposta de sucesso (201)
{ "success": true, "message": "Contact remove operation queued", "data": { "operation_id": 789, "contact_id": "[email protected]", "status": "pending" }}Tratamento de erros
A API usa códigos de status HTTP padrão. Aqui estão as respostas de erro comuns:
Erro de autenticação (401)
{ "success": false, "message": "Invalid or inactive API key"}Erro de validação (422)
{ "success": false, "message": "Validation failed", "errors": { "mobile": ["The mobile field is required when group id is not present."], "message": ["The message field is required."] }}O que você pode construir
Integração com CRM
Envie mensagens de acompanhamento, lembretes e atualizações diretamente do seu sistema de CRM.
Confirmações de agendamento
Envie automaticamente confirmações e lembretes de compromissos aos clientes.
Notificações de pedidos
Notifique os clientes sobre status do pedido, atualizações de envio e informações de entrega.
Sistemas de alerta
Envie alertas e notificações importantes à sua equipe ou aos clientes.
Campanhas de marketing
Envie mensagens promocionais e atualizações à sua lista de contatos.
Fluxos de trabalho personalizados
Integre com Zapier, Make, n8n ou qualquer plataforma de automação.
Mais APIs em breve
Estamos expandindo nossa oferta de APIs para cobrir mais plataformas e casos de uso.
API de Chatbot
Acione respostas do chatbot e gerencie conversas de forma programática.
API de Contatos
Acesse e gerencie seus contatos de mensageiros em todas as plataformas.
Webhooks
Receba notificações em tempo real quando mensagens forem recebidas ou enviadas.