Skip to main content

Criando um grupo

Conceitos​

Para os grupos teremos as funcionalidades de um grupo de whatsapp como a Criação,Adicionar participantes,Apagar um grupo dentre outras funcionalidades. Sendo os métodos divididos da seguinte maneira.

  • Criação de um grupo
  • Buscar todos os grupos
  • Adicionar um participante
  • Buscar um grupo
  • Atualizar as informações do grupo
  • Sair do grupo
  • Deletar grupo
  • Definir imagem do grupo

Métodos​

/groups

POST https://api.jlivery.com/api/v1/wa/SEU_TOKEN/groups

Esse método irá criar o grupo sendo necessario o token da instância.

Veja um exemplo de requisição:

{
  "name": "Grupo de Teste",
  "description": "Grupo de teste com description",
  "auto_invite": false,
  "locked": false,
  "disappearing_timer": "24h", //Podendo escolher entre 24h, 7d ou 90d para desaparecer com todas as mensagens.
  "picture_url": "https://av-eks-blogoptimized.s3.amazonaws.com/ai-generated-gba2dce9e3_1920-thumbnail_webp-600x300.png",
  "participants": [
    {
      "phone": "5583981269787",
      "action": "add" // As actions serão responsaveis por realizar determinadas ações como adcionar ou remover um contato por exemplo.
    }
  ]
}

Response​

200​

{
  "status": 200,
  "message": "",
  "data": {
    "id": "120363177412184724-group", // Ele irá criar um ID para esse grupo.
    "owner": "55xxxxxxxxxxx",
    "name": "Grupo de Teste",
    "description": "",
    "is_locked": false,
    "is_parent": false,
    "is_ephemeral": false,
    "disappearing_timer": 0,
    "member_add_mode": "admin_add",
    "created_at": "2023-10-21T12:44:43Z",
    "invitation_link": "https://chat.whatsapp.com/CqdEJs96Kr0HuC2bwdaeTq",
    "picture_url": "",
    "participants": [
      // Aqui irá trazer todos os participantes incluindo também o criador do grupo.
      {
        "phone": "55xxxxxxxxxxx",
        "is_admin": true,
        "is_super_admin": true,
        "display_name": ""
      },
      {
        "phone": "55xxxxxxxxxxx",
        "is_admin": false,
        "is_super_admin": false,
        "display_name": ""
      }
    ],
    "rejected_phones": []
  }
}

400​

{
  "status": 400,
  "message": "record not found Failed find instance",
  "data": null
}

Nesse caso terá que ver se seu token da instância foi passado corretamente.

401​

{
  "status": 401,
  "message": "Unauthorized",
  "data": null
}

Se o erro for de 401 terá que verificar o método de autenticação e ver se foi passado corretamente.

403​

{
  "status": 403,
  "message": "Forbidden",
  "data": null
}

Já neste caso terá que ver se seu Client-Secret foi passado corretamente.