v1.0
📄 Documentação
📋 Exemplos de código
🔑 Chaves de API
🔐
Como autenticar: Clique em Authorize (cadeado 🔒 no topo da documentação abaixo), cole sua chave de API e clique em Authorize. Depois é só usar o botão Execute em cada endpoint.
Gerar minha chave →

Exemplos de código

Substitua SUA_CHAVE pela chave gerada na aba Chaves de API e 5511988887777 pelo número WhatsApp remetente (com DDI+DDD, só dígitos) — é o número que aparece como remetente para o destinatário.

POST /v1/messages/send
Enviar mensagem de texto
curl -X POST https://apidev.iazis.com.br/v1/messages/send \
  -H "Content-Type: application/json" \
  -H "x-api-key: SUA_CHAVE" \
  -d '{
    "phone": "5511988887777",
    "to": "5511999998888",
    "text": "Olá! Seu pedido foi confirmado. 🎉"
  }'
const response = await fetch('https://apidev.iazis.com.br/v1/messages/send', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-api-key': 'SUA_CHAVE'
  },
  body: JSON.stringify({
    phone: '5511988887777',
    to: '5511999998888',
    text: 'Olá! Seu pedido foi confirmado. 🎉'
  })
});

const data = await response.json();
console.log(data);
// { ok: true, messageId: '3EB0ABC123DEF456', timestamp: 1721743200 }
import requests

response = requests.post(
    'https://apidev.iazis.com.br/v1/messages/send',
    headers={
        'Content-Type': 'application/json',
        'x-api-key': 'SUA_CHAVE'
    },
    json={
        'phone': '5511988887777',
        'to': '5511999998888',
        'text': 'Olá! Seu pedido foi confirmado. 🎉'
    }
)

data = response.json()
print(data)
# {'ok': True, 'messageId': '3EB0ABC123DEF456', 'timestamp': 1721743200}
{
  "ok": true,
  "messageId": "3EB0ABC123DEF456",
  "timestamp": 1721743200
}
{
  "ok": false,
  "error": "Instância desconectada — reconecte no painel"
}
GET /v1/messages/{messageId}/status
Consultar status de entrega
curl https://apidev.iazis.com.br/v1/messages/3EB0ABC123DEF456/status \
  -H "x-api-key: SUA_CHAVE"
const messageId = '3EB0ABC123DEF456'; // ID retornado no envio

const response = await fetch(
  `https://apidev.iazis.com.br/v1/messages/${messageId}/status`,
  { headers: { 'x-api-key': 'SUA_CHAVE' } }
);

const data = await response.json();
console.log(data.status);
// 'sent' | 'delivered' | 'read' | 'error'
import requests

message_id = '3EB0ABC123DEF456'  # ID retornado no envio

response = requests.get(
    f'https://apidev.iazis.com.br/v1/messages/{message_id}/status',
    headers={ 'x-api-key': 'SUA_CHAVE' }
)

data = response.json()
print(data['status'])
# 'sent' | 'delivered' | 'read' | 'error'
{
  "ok": true,
  "messageId": "3EB0ABC123DEF456",
  "status": "delivered",
  "statusCode": 2,
  "to": "5511999998888",
  "type": "text",
  "sentAt": "2026-07-23T15:30:00Z",
  "updatedAt": "2026-07-23T15:30:05Z"
}
POST /v1/messages/media
Enviar imagem / documento / áudio / vídeo
curl -X POST https://apidev.iazis.com.br/v1/messages/media \
  -H "Content-Type: application/json" \
  -H "x-api-key: SUA_CHAVE" \
  -d '{
    "phone": "5511988887777",
    "to": "5511999998888",
    "mediaType": "image",
    "mediaUrl": "https://exemplo.com/foto.jpg",
    "caption": "Confira nossa proposta!"
  }'
const response = await fetch('https://apidev.iazis.com.br/v1/messages/media', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-api-key': 'SUA_CHAVE'
  },
  body: JSON.stringify({
    phone: '5511988887777',
    to: '5511999998888',
    mediaType: 'document',        // image | video | audio | document
    mediaUrl: 'https://exemplo.com/contrato.pdf',
    caption: 'Seu contrato para assinatura',
    fileName: 'contrato.pdf'      // opcional, recomendado para documentos
  })
});

const data = await response.json();
console.log(data);
import requests

response = requests.post(
    'https://apidev.iazis.com.br/v1/messages/media',
    headers={
        'Content-Type': 'application/json',
        'x-api-key': 'SUA_CHAVE'
    },
    json={
        'phone': '5511988887777',
        'to': '5511999998888',
        'mediaType': 'image',   # image | video | audio | document
        'mediaUrl': 'https://exemplo.com/foto.jpg',
        'caption': 'Confira nossa proposta!'
    }
)

print(response.json())
{
  "ok": true,
  "messageId": "3EB0XYZ987654321",
  "timestamp": 1721743260
}
⚠️ Atenção: o campo mediaUrl deve ser uma URL HTTPS pública — não aceita base64, paths locais nem URLs internas (ex: localhost).

Chaves de API

Gerencie as chaves de acesso à IAZIS Messaging REST API. Cada chave é mostrada apenas uma vez no momento da criação.

Entrar na conta

Use o mesmo email e senha do painel IAZIS.