Saltar al contenido principal

Grupos de Instancias

Crea grupos que contengan múltiples instancias y úsalos como si fueran un solo número de WhatsApp.

Instance Group

Principalmente utilizados para distribución de envío de mensajes, donde el grupo de instancias distribuirá uniformemente la carga y usará solo instancias activas, minimizando el riesgo de bloqueo de instancias.

Crear Nuevo Grupo​

La creación de grupos está limitada a la interfaz del sistema. Accede al menú Grupos de Instancias para registrar un nuevo grupo de instancias.

Estado del Grupo​

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

Información del grupo:

{
    "Resultado": {
        "CodigoResultado": 0,
        "Mensagem": "10 instances. Connected=7, canRestore=2, disconnected=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": []
    }
}

Apagar Grupo de Instancias​

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

Iniciar Grupo de Instancias​

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

Consulta de Perfil​

Distribuye consultas de perfil entre las instancias del grupo.

Comandohttps://apidb.witi.me/witime/group/query_profile.aspx?gid=GROUP_ID
MétodoPOST
Cuerpo
{ 
    "number" : ["551198765432@s.whatsapp.net","551191234567@s.whatsapp.net", ...],
    "queryPicture" : true // optional
}
Respuesta
{
    "Resultado": {
        "CodigoResultado": 0,
        "Mensagem": "2 profiles queried. {\"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 Mensaje​

Distribuye el envío de mensajes entre las instancias del grupo, de forma aleatoria y según la disponibilidad de las instancias.

Comandohttps://apidb.witi.me/witime/group/SendMessage.aspx?gid=GROUP_ID
MétodoPOST
Cuerpo
{ 
    "number": "551199887766@s.whatsapp.net",
    "message": "Hello! This is a test via the witi.me API!",
    "sms_delivery_uniqueid": "" // optional
}
Respuesta

Información del grupo:

{
    "Resultado": {
        "CodigoResultado": 0,
        "Mensagem": "Message sent successfully",
        "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": "Hello! This is a test via the witi.me API!",
        "From_me": false,
        "Forwarded": false,
        "Json_event": null,
        "EventIdRef": null,
        "UniqueIdRef": "",
        "MensagemRef": null,
        "EventId": "F19E8B61600CA75224D8E5453550D8C4"
    }
}