Skip to main content

Grupos de Instâncias

Crie grupos contendo várias instâncias e utilize como se fosse um único número de WhatsApp.

Grupo de Instâncias

Utilizado principalmente para distribuição do envio de mensagens, onde o grupo de instâncias irá fazer a distribuição homogênea da carga, e utilização apenas das instâncias ativas, minimizando o risco de bloqueios das instâncias.

Criar novo grupo​

A criação de um grupo está limitada a interface do sistema. Acesse o menu Grupos de Instâncias para cadastrar um novo grupo de instâncias.

Status do grupo​

Comandohttps://apidb.witi.me/witime/group/getstatus.aspx?gid=ID_DO_GRUPO
MétodoGET
Retorno

Informações do grupo:

{
    "Resultado": {
        "CodigoResultado": 0,
        "Mensagem": "10 instancias. Conectado=7, canRestore=2, desconectado=1",
        "Chave": "7bd11041-196e-3a38-bc26-4aa81437cd38",
        "Cobrado": false,
        "ValorCobrado": 0.0,
        "ElapsedTimeMS": 0
    },
    "Info": {
        "GID": "a1e9e5d7-0f8e-4aa4-bae1-b50e13577079",
        "WIDs": [],
        "APIURL": null,
        "Status": 1,
        "instancias": []
    }
}

Desligar Grupo de Instâncias​

Comandohttps://apidb.witi.me/witime/group/End.aspx?gid=ID_DO_GRUPO
MétodoGET
Corpo
{
    "CodigoResultado": 0,
    "Mensagem": "GID a1e9e5d7-0f8e-4aa4-bae1-b50e13577079 finalizado com sucesso",
    "Chave": "7bd11041-196e-3a38-bc26-4aa81437cd38",
    "Cobrado": false,
    "ValorCobrado": 0.0,
    "ElapsedTimeMS": 4480
}

Ligar Grupo de Instâncias​

Comandohttps://apidb.witi.me/witime/group/Start.aspx?gid=ID_DO_GRUPO
MétodoGET
Corpo
{
    "CodigoResultado": 0,
    "Mensagem": "GID a1e9e5d7-0f8e-4aa4-bae1-b50e13577079 iniciado com sucesso. 1 wids",
    "Chave": "7bd11041-196e-3a38-bc26-4aa81437cd38",
    "Cobrado": false,
    "ValorCobrado": 0.0,
    "ElapsedTimeMS": 18
}

Consulta de profiles​

Distribui a consulta de profiles entre as instâncias do grupo.

Comandohttps://apidb.witi.me/witime/group/query_profile.aspx?gid=ID_DO_GRUPO
MétodoPOST
Corpo
{ 
    "number" : ["551198765432@s.whatsapp.net","551191234567@s.whatsapp.net", ...],
    "queryPicture" : true // opcional
}
Retorno
{
    "Resultado": {
        "CodigoResultado": 0,
        "Mensagem": "2 profiles consultados. {\"200\":2}",
        "Chave": "7bd11041-196e-3a38-bc26-4aa81437cd38",
        "Cobrado": false,
        "ValorCobrado": 0.0,
        "ElapsedTimeMS": 289
    },
    "Profiles": [
        {
            "Status": 200,
            "Contato": {
                "name": "José Maria",
                "picture": "",
                "Lastupdate": "0001-01-01T00:00:00-02:00",
                "LastMessageTime": 1683549454,
                "biz": false,
                "status": 200,
                "tag": null,
                "Count": 27,
                "Mute": false,
                "Spam": false,
                "Archive": false,
                "isGroup": false,
                "jid": "551198765432@s.whatsapp.net"
            },
            "JID": "551198765432@c.us",
            "Picture": null
        },
        ...
    ]
}

Enviar Mensagem​

Distribui o envio de mensagem entre as instâncias do grupo, de forma aleatória e de acordo com a disponibilidade da instância.

Comandohttps://apidb.witi.me/witime/group/SendMessage.aspx?gid=ID_DO_GRUPO
MétodoPOST
Corpo
{ 
    "number": "551199887766@s.whatsapp.net",
    "message": "Olá! Este é um teste pela API do witi.me!",
    "sms_delivery_uniqueid": "" // opcional
}
Retorno

Informações do grupo:

{
    "Resultado": {
        "CodigoResultado": 0,
        "Mensagem": "Mensagem enviada com sucesso",
        "Chave": "04f18780-6c03-4699-9277-8fad93708a2a",
        "Cobrado": false,
        "ValorCobrado": 0.0,
        "ElapsedTimeMS": 5857
    },
    "Mensagem": {
        "JidSource": "551198765421@s.whatsapp.net",
        "JidDestiny": "551199887766@s.whatsapp.net",
        "JidChatName": null,
        "Status": 1,
        "_event_id_hash": 77880376,
        "Type": null,
        "DateSent": "2023-05-08T15:54:26.0212253-03:00",
        "TextMessage": "Olá! Este é um teste pela API do witi.me!",
        "From_me": false,
        "Forwarded": false,
        "Json_event": null,
        "EventIdRef": null,
        "UniqueIdRef": "",
        "MensagemRef": null,
        "EventId": "F19E8B61600CA75224D8E5453550D8C4"
    }
}