Skip to main content
POST
/
messages
Enviar Contato
curl --request POST \
  --url https://apis.vectalk.com.br/api/messages \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "messaging_product": "<string>",
  "to": "<string>",
  "type": "<string>",
  "context": {
    "context.message_id": "<string>"
  },
  "contacts": [
    {}
  ]
}
'

​
Parâmetros

​
Body

​
messaging_product
string
default:"whatsapp"
required
Sempre "whatsapp".
​
to
string
required
Número do destinatário no formato wa_id.
​
type
string
default:"contacts"
required
Sempre "contacts".
​
context
object
Para responder uma mensagem específica.
​
contacts
array
required
Array de objetos de contato.

​
Exemplo

{
  "messaging_product": "whatsapp",
  "to": "5511999999999",
  "type": "contacts",
  "contacts": [
    {
      "addresses": [
        {
          "street": "Av. Paulista, 1000",
          "city": "São Paulo",
          "state": "SP",
          "zip": "01310-100",
          "country": "Brasil",
          "country_code": "BR",
          "type": "WORK"
        }
      ],
      "birthday": "1990-05-15",
      "emails": [
        {
          "email": "contato@empresa.com",
          "type": "WORK"
        }
      ],
      "name": {
        "formatted_name": "João Silva",
        "first_name": "João",
        "last_name": "Silva"
      },
      "org": {
        "company": "Empresa LTDA",
        "department": "Vendas",
        "title": "Gerente"
      },
      "phones": [
        {
          "phone": "+5511999999999",
          "wa_id": "5511999999999",
          "type": "WORK"
        }
      ],
      "urls": [
        {
          "url": "https://empresa.com",
          "type": "WORK"
        }
      ]
    }
  ]
}

​
Campos do Contato

CampoTipoDescrição
name.formatted_namestringNome formatado (obrigatório)
name.first_namestringPrimeiro nome
name.last_namestringSobrenome
name.middle_namestringNome do meio
name.prefixstringPrefixo (Sr., Dr.)
name.suffixstringSufixo (Jr., III)
phones[].phonestringNúmero de telefone
phones[].wa_idstringWhatsApp ID
phones[].typestringHOME ou WORK
emails[].emailstringEmail
emails[].typestringHOME ou WORK
addresses[].streetstringRua
addresses[].citystringCidade
addresses[].statestringEstado
addresses[].zipstringCEP
addresses[].countrystringPaís
addresses[].country_codestringCódigo do país
addresses[].typestringHOME ou WORK
org.companystringEmpresa
org.departmentstringDepartamento
org.titlestringCargo
birthdaystringData de nascimento (YYYY-MM-DD)
urls[].urlstringURL
urls[].typestringHOME ou WORK

​
Resposta

{
  "messaging_product": "whatsapp",
  "contacts": [{ "input": "5511999999999", "wa_id": "5511999999999" }],
  "messages": [{ "id": "wamid.HBgLNTUxMTk5OTk5OTk5..." }]
}