Enviar mensagem
Veja detalhes de como realizar o envio de mensagens.
A partir deste serviço você poderá enviar mensagens individuais ou em massa através do número sincronizado na instância do seu usuário.
Fique atento quanto ao rate-limit de requisições para o correto funcionamento da API.
REST (JSON)
POST
https://api-v2.smsfire.com.br/whatsapp/send/bulk
A partir deste método você poderá realizar envios individuais ou em massa a destinatários que façam ou não parte da sua lista de contatos no WhatsApp, podendo especificar um texto personalizado para cada um deles ou até para o mesmo destinatário para criar diferentes blocos de mensagem
Atenção: Campos com * (asterisco) são obrigatórios
Headers
Request Body
O parâmetro
customId
aceita caracteres alfanuméricos, hífen, underline/underscore e ponto sem espaços ou quebra de linha.
É possível enviar no máximo 250 destinatários por requisição. As mensagens enviadas são processadas em períodos aleatórios entre 0 a 3 segundos.
As mensagens enviadas possuem um TTL (time to live) de 24 horas para serem processadas por instância. Caso não tenham sido processadas até este período, as mensagens serão removidas da fila de processamento e receberão o status EXPIRED e essa alteração de status não é notificada via webhooks.
Exemplos de requisição
Exemplo simplificado de requisição com parâmetros mínimos obrigatórios:
Exemplo de JSON com todos os parâmetros existentes no serviço:
É possível a inclusão de emojis e acentuação no texto. Para isso envie os dados sob o encoding UTF-8 Unicode.
Quando o parâmetro
mediaUrl
for mencionado, o parâmetrotext
poderá ser omitido.
Quando a url informada for inválida - automaticamente - o parâmetro mediaUrl
é ignorado e então o text
volta a ser obrigatório.
Suporte a multimídia
Este serviço suporta o envio e recebimento de mensagens multimídia, entretanto, há limites de tamanho e tipos específicos de arquivos que poderão ser utilizados. Veja abaixo os MIME-TYPES de arquivos permitidos:
O tamanho máximo do arquivo enviado são de 3 MB
Mídias do tipo imagem e vídeo possuem suporte ao parâmetro text
enquanto que as do tipo áudio e arquivos não possuem e por isso o conteúdo inserido no parâmetro text
será ignorado.
Os arquivos multimídia em mensagens enviadas por API não são armazenados, enquanto arquivos de mensagens recebidas são armazenados por um prazo de sete dias corridos a partir da data do recebimento, e uma url pública é fornecida para acesso a eles. Após o período de sete dias os arquivos são apagados permanentemente dos nossos servidores.
Last updated