POST
/
message
/
contact
curl --request POST \
  --url https://api.interacto.io/message/contact \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --header 'Instance-Id: <instance-id>' \
  --data '{
  "to": "5511999999999",
  "contact": {
    "name": "João Silva",
    "phone": "5511999999999"
  },
  "delay": 2,
  "typing": 8,
  "priority": 2,
  "tags": [
    "urgente",
    "lead"
  ],
  "metadata": {
    "leadId": "1234533"
  }
}'
{
  "statusCode": 201,
  "message": "request successful",
  "data": {
    "id": "66b3c041eac929f51c6f160f",
    "instanceId": "66a09db606fd14660c8fc1d0",
    "to": "551198888888",
    "midia": {
      "name": "Joe Doe",
      "phone": "5511999999999"
    },
    "status": "QUEUED",
    "sended": false,
    "priority": 123,
    "timestamp": "2023-11-07T05:31:56Z",
    "metadata": {}
  }
}

​
Notas

Certifique-se de que o número do destinatário esteja no formato internacional (E.164). O tempo de atraso e a simulação de digitação são úteis para criar uma experiência mais natural de envio de mensagens, especialmente em aplicações onde o realismo na comunicação é importante.

​
Atenção!

Recomendamos fortemente que você utilize as opções de delay ou typing ao enviar múltiplas mensagens em sequência. O envio de mensagens em grande volume sem essas configurações pode resultar no bloqueio temporário ou permanente de sua conta no WhatsApp. Use essas opções para garantir uma experiência mais natural e segura na plataforma.

Authorizations

​
Authorization
string
header
required

API Key needed to access the endpoints

Headers

​
Instance-Id
string
required

Unique identifier for the instance

Body

application/json
​
to
string
required

Destinatário da mensagem

Example:

"5511999999999"

​
contact
object
required

Informações do contato

​
delay
number

Atraso opcional para envio da mensagem em segundos

Example:

2

​
typing
number

Atraso opcional de digitação em segundos

Example:

8

​
priority
number

Prioridade opcional da mensagem em inteiro

Example:

2

​
tags
string[]

Array opcional de tags

Example:
["urgente", "lead"]
​
metadata
object

Objeto opcional de metadados

Example:
{ "leadId": "1234533" }

Response

201 - application/json
Message sent successfully
​
statusCode
integer
Example:

201

​
message
string
Example:

"request successful"

​
data
object