Log in
Yup Chat

APIs de Mensagens

Envie e receba mensagens através de SMS, WhatsApp, RCS e Email com uma única integração. Suporte completo a webhooks e rastreamento em tempo real.

Endpoints Disponíveis

POST/sms/send

Enviar mensagens SMS

Limite: 10.000 req/min

POST/whatsapp/send

Enviar mensagens WhatsApp

Limite: 10.000 req/min

POST/rcs/send

Enviar mensagens RCS

Limite: 10.000 req/min

POST/email/send

Enviar emails

Limite: 10.000 req/min

GET/messages/{id}

Obter status de uma mensagem

Limite: Ilimitado

GET/messages

Listar mensagens com filtros

Limite: Ilimitado

Exemplos de Código

Enviar SMS via cURL

bash

curl -X POST https://api.yup.chat/v1/sms/send \
  -H "Authorization: Basic $(echo -n 'API_ID:SECRET_TOKEN' | base64)" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+5511999999999",
    "message": "Seu código é: 123456",
    "sender_id": "YupChat"
  }'

Enviar SMS via JavaScript

javascript

const apiId = 'seu_api_id';
const secretToken = 'seu_token_secreto';
const auth = btoa(`${apiId}:${secretToken}`);

fetch('https://api.yup.chat/v1/sms/send', {
  method: 'POST',
  headers: {
    'Authorization': `Basic ${auth}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    to: '+5511999999999',
    message: 'Seu código é: 123456',
    sender_id: 'YupChat'
  })
})
.then(res => res.json())
.then(data => console.log(data));

Enviar WhatsApp via cURL

bash

curl -X POST https://api.yup.chat/v1/whatsapp/send \
  -H "Authorization: Basic $(echo -n 'API_ID:SECRET_TOKEN' | base64)" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+5511999999999",
    "type": "text",
    "message": "Olá! Como posso ajudar?"
  }'

Enviar Email via JavaScript

javascript

const apiId = 'seu_api_id';
const secretToken = 'seu_token_secreto';
const auth = btoa(`${apiId}:${secretToken}`);

fetch('https://api.yup.chat/v1/email/send', {
  method: 'POST',
  headers: {
    'Authorization': `Basic ${auth}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    to: '[email protected]',
    subject: 'Bem-vindo!',
    body: '<h1>Olá!</h1><p>Bem-vindo à Yup Chat</p>',
    from: '[email protected]'
  })
})
.then(res => res.json())
.then(data => console.log(data));

Respostas da API

Sucesso (200)

{
  "id": "msg_1234567890",
  "status": "sent",
  "to": "+5511999999999",
  "message": "Seu código é: 123456",
  "timestamp": "2024-01-18T10:30:00Z",
  "cost": 0.50
}

Erro (400)

{
  "error": "invalid_phone_number",
  "message": "O número de telefone não é válido",
  "code": 400,
  "details": {
    "field": "to",
    "value": "+55119"
  }
}

Webhooks em Tempo Real

Receba notificações instantâneas sobre o status de suas mensagens através de webhooks. Configure a URL do seu webhook no dashboard.

{
  "event": "message.delivered",
  "timestamp": "2024-01-18T10:30:00Z",
  "message_id": "msg_1234567890",
  "to": "+5511999999999",
  "status": "delivered",
  "channel": "sms"
}

Eventos Suportados

  • ✓ message.sent
  • ✓ message.delivered
  • ✓ message.failed
  • ✓ message.received

Retry Policy

  • • Máximo 5 tentativas
  • • Backoff exponencial
  • • Timeout: 30 segundos
  • • Assinatura HMAC-SHA256

Boas Práticas

Validação de Números

  • Use formato E.164 (+5511999999999)
  • Valide antes de enviar
  • Trate erros de número inválido

Rate Limiting

  • Implemente backoff exponencial
  • Monitore seu uso
  • Solicite aumento de limite se necessário

Segurança

  • Nunca exponha suas credenciais
  • Use HTTPS sempre
  • Valide assinaturas de webhooks

Confiabilidade

  • Implemente retry logic
  • Use webhooks para confirmação
  • Monitore taxa de entrega

Comece a Integrar Agora

Acesse o dashboard para gerar suas credenciais e comece a enviar mensagens em minutos.

👋 Oi! Podemos te
ajudar agora mesmo.