Contato

POST

https://waba.optjuntos.com.br/api/v1/messages

👤 Mensagens de Contato

As mensagens de contato permitem que você compartilhe informações de contato com os seus clientes através do WhatsApp.

Mensagem de contato recebida no WhatsApp

Quando o usuário toca na seta de perfil da mensagem, os dados completos do contato são exibidos em uma visualização dedicada:

Boas práticas

Inclua sempre o campo formatted_name no objeto name

Se possível, forneça números de telefone no formato internacional (com código do país)

Você pode enviar múltiplos contatos em uma única mensagem

Verifique quais campos são importantes para o seu caso de uso, pois nem todos são obrigatórios

Requisição

Authorization

Forneça seu token bearer no cabeçalho

Authorization

ao fazer requisições para recursos protegidos.

Exemplo:

Authorization: Bearer ********************

Parâmetros Bodyapplication/json

Exemplo

{
    "messaging_product": "whatsapp",
    "recipient_type": "individual",
    "to": "{{recipient_number}}",
    "type": "contacts",
    "contacts": [
        {
            "name": {
                "formatted_name": "João Silva",
                "first_name": "João",
                "last_name": "Silva"
            },
            "phones": [
                {
                    "phone": "+5511999999999",
                    "type": "CELL"
                }
            ],
            "emails": [
                {
                    "email": "joao.silva@exemplo.com",
                    "type": "WORK"
                }
            ]
        }
    ]
}

Exemplos de Requisição

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://waba.optjuntos.com.br/api/v1/messages' \
--header 'Content-Type: application/json' \
--data-raw '{
    "messaging_product": "whatsapp",
    "recipient_type": "individual",
    "to": "5517991677564",
    "type": "contacts",
    "contacts": [
        {
            "name": {
                "formatted_name": "João Silva",
                "first_name": "João",
                "last_name": "Silva"
            },
            "phones": [
                {
                    "phone": "+5511999999999",
                    "type": "CELL"
                }
            ],
            "emails": [
                {
                    "email": "joao.silva@exemplo.com",
                    "type": "WORK"
                }
            ]
        }
    ]
}'

Respostas

🟢200OK

application/json

✅ Contato enviado com sucesso

Body

Exemplo

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

🟠400Pedido inválido

🟠401Não autorizado

🔴500Erro do servidor

Modificado em 2025-04-08 06:44:05