Atualizar status de presença da instância

curl --request POST \
  --url https://api.zappfy.io/instance/presence \
  --header 'Content-Type: application/json' \
  --header 'token: <api-key>' \
  --data '
{
  "presence": "available"
}
'

{
  "response": "Presence updated successfully"
}

Instancia

Atualizar status de presença da instância

Atualiza o status de presença global da instância do WhatsApp. Este endpoint permite:

Definir se a instância está disponível (Aparece “online”) ou indisponível
Controlar o status de presença para todos os contatos
Salvar o estado atual da presença na instância

Tipos de presença suportados:

available: Marca a instância como disponível/online
unavailable: Marca a instância como indisponível/offline

Atenção:

O status de presença pode ser temporariamente alterado para “available” (online) em algumas situações internas da API, e com isso o visto por último também pode ser atualizado.
Caso isso for um problema, considere alterar suas configurações de privacidade no WhatsApp para não mostrar o visto por último e/ou quem pode ver seu status “online”.

⚠️ Importante - Limitação do Presence “unavailable”:

Quando a API é o único dispositivo ativo: Confirmações de entrega/leitura (ticks cinzas/azuis) não são enviadas nem recebidas
Impacto: Eventos message_update com status de entrega podem não ser recebidos
Solução: Se precisar das confirmações, mantenha WhatsApp Web ou aplicativo móvel ativo ou use presence “available”

Exemplo de requisição:

{
  "presence": "available"
}

Exemplo de resposta:

{
  "response": "Presence updated successfully"
}

Erros comuns:

401: Token inválido ou expirado
400: Valor de presença inválido
500: Erro ao atualizar presença

POST

instance

presence

Atualizar status de presença da instância

curl --request POST \
  --url https://api.zappfy.io/instance/presence \
  --header 'Content-Type: application/json' \
  --header 'token: <api-key>' \
  --data '
{
  "presence": "available"
}
'

{
  "response": "Presence updated successfully"
}

Autorizações

token

string

header

obrigatório

Corpo

application/json

presence

enum<string>

obrigatório

Status de presença da instância

Opções disponíveis:

available,

unavailable

Exemplo:

"available"

Resposta

Presença atualizada com sucesso

response

string

Mensagem de confirmação

Exemplo:

"Presence updated successfully"

Alterar configurações de privacidade Chatbot Configurações