Skip to main content
POST
/
instances
/
{instanceId}
/
token
/
{instanceToken}
/
send-contacts
curl --request POST \ --url https://api.ezapi.com.br/instances/{instanceId}/token/{instanceToken}/send-contacts \ --header 'Client-Token: <api-key>' \ --header 'Content-Type: application/json' \ --data ' { "phone": "{{PHONE}}", "contacts": [ { "name": "Nome do contato", "phones": [ "{{PHONE}}", "{{PHONE}}" ] }, { "name": "Nome do contato", "phones": [ "{{PHONE}}" ] }, { "name": "Nome do contato", "phones": [ "{{PHONE}}" ], "businessDescription": "Uma empresa do Grupo Irrah" } ] } '
{
  "messageId": "3EB047ED70306656281B34",
  "id": "3EB047ED70306656281B34"
}
{
  "error": "Unauthorized",
  "message": "Invalid instanceToken"
}
{
  "error": "Instance not found"
}
{
  "error": "Worker command timeout"
}
{
  "error": "Unable to process request"
}
Envia uma lista de contatos em uma única mensagem.

Authorizations

​
Client-Token
string
header
required

Path Parameters

​
instanceId
string
required

Identificador único da instância.

Example:

"abc1234567890"

​
instanceToken
string
required

Token privado da instância retornado na criação.

Example:

"tok_a1b2c3d4e5f6"

Body

application/json
​
phone
string
required

Número com código do país (ex: 554499999999) ou JID de grupo (ex: 120363123456789@g.us)

Example:

"{{PHONE}}"

​
contacts
object[]
required
Example:
[
  {
    "name": "Nome do contato",
    "phones": ["{{PHONE}}", "{{PHONE}}"]
  },
  {
    "name": "Nome do contato",
    "phones": ["{{PHONE}}"]
  },
  {
    "name": "Nome do contato",
    "phones": ["{{PHONE}}"],
    "businessDescription": "Uma empresa do Grupo Irrah"
  }
]
​
mentioned
string[]

Lista de números para mencionar em grupos

Example:
["554499999999"]
​
mentionsEveryOne
boolean
default:false

Mencionar todos os participantes do grupo

Response

Resposta de sucesso.

​
messageId
string
required
Example:

"3EB047ED70306656281B34"

​
id
string
required
Example:

"3EB047ED70306656281B34"