Skip to main content

Mensagens

Chats​

Comandochats.aspx
MétodoGET
Retorno

SUCESSO → Lista contendo os últimos chats visíveis ao usuário:

[
    {
        "jid": "5511987654321@s.whatsapp.net",
        "name": "",
        "spam": false,
        "count": 0,
        "mute": "",
        "t": 1602182138,
        "archive": false,
        "modify_tag": "761618",
        "picture": "",
        "Lastupdate": "0001-01-01T02:00:00Z"
    },
    ...

ERRO → Retorno vazio

Enviar Mensagem​

Comandosend_message.aspx
MétodoPOST
Corpo
{ 
    "number": "5511987654321@s.whatsapp.net", 
    "message": "Olá"
}

Formatação do texto

EfeitoDescriçãoExemplo
NegritoTexto entre asteríscos*Negrito*
RiscadoTexto entre dois caracteres til~Riscado~
ItálicoTexto entre dois caracteres de underline_Itálico_
MonoespaçoTexto no formato mono espaço```Monoespaço```
Nova
linha		Para quebra de linha utilizar o caractere \nNova\nlinha
Retorno
{
    {
        "sucesso": true,
        "mensagem": {
            "Id": "61C14232F8748A08677DF4775ECBBE33" 
        }
    }
}

Id ID único da Mensagem

Enviar Imagem​

Comandosend_message_file.aspx
MétodoPOST
Corpo
{ 
    "number": "5511987654321@s.whatsapp.net", 
    "caption": "Descrição da Imagem",
    "url": "https://images.pexels.com/photos/4627455/pexels-photo-4627455.jpeg",
    "type": "image/jpeg",
    "filename": "", // opcional
    "base64": "",   // se o arquivo não for hospedado em uma url, utilize o arquivo em base64
    "mimetype": ""  // obrigatório se imagem for base64
}
Retorno
{
    "sucesso": true,
    "mensagem": {
        "MessageID": "6AFCFEAB7FC3ECA3753F1C8AB86ADF15",
        "Url": "https://api.witi.me/static/6D6307C3-2973-4468-85FA-D047CB8E1F2B/media/6AFCFEAB7FC3ECA3753F1C8AB86ADF15",
        "jpegThumbnail": ""
    }
}

ERRO:

{
    "sucesso": false,
    "mensagem": null
}

Enviar Arquivo​

Comandosend_message_file.aspx
MétodoPOST
Corpo
{ 
    "number": "5511987654321@s.whatsapp.net", 
    "caption": "Descrição do Documento",
    "url": "https://filesamples.com/samples/document/txt/sample1.txt",
    "type": "file",
    "filename": "", // opcional
    "base64": "",   // se o arquivo não for hospedado em uma url, utilize o arquivo em base64
    "mimetype": ""  // obrigatório se utilizado base64
}
Retorno
{
    "sucesso": true,
    "mensagem": {
        "MessageID": "6AFCFEAB7FC3ECA3753F1C8AB86ADF15",
        "Url": "https://api.witi.me/static/6D6307C3-2973-4468-85FA-D047CB8E1F2B/media/6AFCFEAB7FC3ECA3753F1C8AB86ADF15",
        "jpegThumbnail": ""
    }
}

Enviar Áudio​

Comandosend_message_file.aspx
MétodoPOST
Corpo
{ 
    "number": "5511987654321@s.whatsapp.net", 
    "caption": "audio.wav",
    "type": "audio",
    "mimetype": "audio/wav",
    "base64": "GkXfo59ChoEBQveBAULy...",
}
Atenção

O arquivo de áudio deve estar no formato wav

Enviar Contato​

Envia uma mensagem de contato, utilizando o formato vcard.

Comandosend_contact.aspx
MétodoPOST
Corpo
{ 
    "jid": "5511987654321@s.whatsapp.net", 
    "vcard": "BEGIN:VCARD\nVERSION:3.0\nN:;Fulano da Silva;;\nFN:Fulano da Silva\nitem1.TEL;waid=5511987654321@s.whatsapp.net:+5511987654321@s.whatsapp.net\nitem1.X-ABLabel:Mobile\nEND:VCARD"    
}
Resultado
{
    "sucesso": true,
    "mensagem": {
        "Id": "3EB06E1CAC62CAEB8219"
    }
}

Inscrever-se​

Sinaliza que a conversa foi iniciada com o contato.

Comandosubscribe.aspx
MétodoPOST
Corpo
{ 
    "number": "5511987654321@s.whatsapp.net",
}
Resultado
{
    "sucesso": true
}

Enviar Presença​

Comandosend_presence.aspx
MétodoPOST
Corpo
{ 
    "jid": "5511987654321@s.whatsapp.net", 
    "status": "composing", // composing | available | unavailable | recording
}
Atenção

Para enviar o comando de presença a um contato, primeiramente é necessário enviar o comando de subscribe.aspx

Informação

Para o recebimento dos eventos por parte do contato, as vezes é exigido pelo WhatsApp, que haja primeiramente uma troca de mensagens inicial entre as partes.

Resultado
{
    "sucesso": true
}

Marcar como lido​

Marca a mensagem recebida como lida, para que o contato receba esta informação.

Comandomark_read.aspx
MétodoPOST
Corpo
{ 
    "jid": "5511987654321@s.whatsapp.net", 
    "messageid": "0272351687E8BA60700B8C6C400E05A6"
}
Resultado
{
    "sucesso": true
}