Guia de integração

Envio de mensagens via BemChat API

Passo a passo para envio de mensagens através da API do BemChat.

Etapa 1

Obtendo o Token de Acesso

Para utilizar a API do BemChat, você precisará de um token de acesso. Este token é essencial para autenticar suas requisições.

Como obter seu token

  1. 1

    Acesse as configurações do BemChat

    Entre na sua conta e navegue até a seção de "API"

  2. 2

    Localize a seção "API Token"

    Dentro das configurações, encontre a opção relacionada à API

  3. 3

    Copie o token gerado

    Use o botão de cópia ou selecione manualmente o token exibido

Exemplo de Uso do Token

1// Exemplo de requisição com o token 2 fetch('https://exemplo.api.bemchat.com.br/api/messages/send', { 3 method: 'POST', 4 headers: { 5 'Authorization': 'Bearer seu_token_aqui', 6 'Content-Type': 'application/json' 7 }, 8 body: JSON.stringify({ 9 number: '5599999999999', 10 body: 'Olá mundo!' 11 }) 12 })
Etapa 2

Enviando Mensagens de Texto

Envie mensagens de texto simples através da API do BemChat. Este endpoint permite enviar mensagens para qualquer número de WhatsApp.

Endpoint

1https://exemplo.api.bemchat.com.br/api/messages/send

Método

POST

Headers

Authorization
Bearer SEU_TOKEN_AQUI
Token de autenticação
Content-Type
application/json
Formato do corpo da requisição

Parâmetros da Requisição

number
String (Obrigatório)
Número do destinatário (ex: 5599999999999)
body
String (Obrigatório)
Mensagem de texto a ser enviada
whatsappId
Number (Opcional)
ID da conta WhatsApp para enviar a mensagem

Exemplos

1{ 2 "number": "5599999999999", 3 "body": "Mensagem enviada via API", 4 "whatsappId": 1 5 }

* O campo whatsappId é opcional.

Etapa 3

Enviando Mensagens com Mídia

Envie mensagens contendo arquivos de mídia (imagens, documentos, áudios e vídeos) através da API do BemChat.

Endpoint

1https://exemplo.api.bemchat.com.br/api/messages/send

Método

POST

Headers

Authorization
Bearer SEU_TOKEN_AQUI
Token de autenticação
Content-Type
multipart/form-data
Formato do corpo da requisição

Parâmetros da Requisição

number
String (Obrigatório)
Número do destinatário (ex: 5599999999999)
medias
File (Obrigatório)
Arquivo de mídia a ser enviado
body
String (Opcional)
Mensagem de texto junto com a mídia
whatsappId
Number (Opcional)
ID da conta WhatsApp

Exemplos

1// Formato: multipart/form-data 2 --NomeAleatorio 3 Content-Disposition: form-data; name="number" 4 5 5599999999999 6 --NomeAleatorio 7 Content-Disposition: form-data; name="medias"; filename="arquivo.jpg" 8 Content-Type: image/jpeg 9 10 (Dados binários do arquivo) 11 --NomeAleatorio 12 Content-Disposition: form-data; name="body" 13 14 Mensagem com mídia 15 --NomeAleatorio--

* Substitua arquivo.jpg pelo nome real do arquivo e ajuste o Content-Type conforme necessário.

Dicas e Boas Práticas

1

Otimize o tamanho dos arquivos

Comprima imagens e vídeos antes de enviar para melhorar o desempenho.

2

Verifique o tipo de arquivo

Certifique-se de que o tipo de arquivo é suportado pelo WhatsApp.

3

Trate erros adequadamente

Implemente tratamento de erros para lidar com falhas no envio de mídia.