Pular para o conteúdo principal
POST
/
instances
/
{instanceId}
/
token
/
{token}
/
send-text
Conversar com a Meta AI
curl --request POST \
  --url https://api.z-api.io/instances/{instanceId}/token/{token}/send-text \
  --header 'Client-Token: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "phone": "<string>",
  "message": "<string>"
}
'

Conceituação

Este método permite a interação direta com a Meta AI no WhatsApp através da Z-API, facilitando o envio de mensagens de texto para obter respostas automatizadas e contextuais. Você pode conversar com a Meta AI em chat privado usando o número 13135550002 ou incluí-la em grupos usando o ID do grupo.
Atualmente, a Meta AI na Z-API suporta apenas mensagens em texto. Isso significa que áudio, documentos, imagens e outros arquivos multimídia não são compatíveis nesta integração.
Esse recurso está disponível apenas para contas pessoais do WhatsApp.

Atributos

instanceId
string
obrigatório
ID da sua instância. Disponível no painel Z-API em Instâncias.
token
string
obrigatório
Token da sua instância Z-API.

Obrigatórios

phone
string
obrigatório
Use 13135550002 para chat privado ou o ID do grupo para conversas em grupo
message
string
obrigatório
Texto da mensagem

Opcionais

delayMessage
number
Delay adicionado na mensagem. Você pode decidir entre um range de 1 a 15 sec
delayTyping
number
Delay com status “Digitando…”. Range de 1 a 15 sec
mentioned
array
Inclua 13135550002 ao mencionar a Meta AI em grupos

Request Body

Chat privado:
{
  "phone": "13135550002",
  "message": "Olá, Meta AI! Gostaria de saber sobre..."
}
Em grupo:
{
  "phone": "5511999999999-group",
  "message": "@13135550002 Olá, Meta AI! Gostaria de saber sobre...",
  "mentioned": [13135550002]
}

Response

200

{
  "zaapId": "3999984263738042930CD6ECDE9VDWSA",
  "messageId": "D241XXXX732339502B68",
  "id": "D241XXXX732339502B68"
}

405

Neste caso certifique que esteja enviando corretamente a especificação do método, ou seja verifique se você enviou o POST ou GET conforme especificado no início deste tópico.

415

Caso você receba um erro 415, certifique de adicionar na headers da requisição o “Content-Type” do objeto que você está enviando, em sua grande maioria “application/json”.