> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wappfy.com.br/llms.txt
> Use this file to discover all available pages before exploring further.
# Enviar Contato (vCard)
> Enviar um ou múltiplos contatos no formato vCard
## Descrição
Este endpoint permite enviar um ou mais contatos no formato vCard para contatos individuais ou grupos no WhatsApp. Os contatos são enviados com nome de exibição e informações no padrão vCard.
## Body
```json theme={null}
{
"sessionId": "my-session",
"jid": "5511999999999@s.whatsapp.net",
"contacts": [
{
"displayName": "João Silva",
"vcard": "BEGIN:VCARD\nVERSION:3.0\nFN:João Silva\nTEL;type=CELL;type=VOICE;waid=5511988887777:+55 11 98888-7777\nEND:VCARD"
}
]
}
```
### Parâmetros do Body
| Propriedade | Tipo | Obrigatório | Descrição |
| ------------------------ | -------- | ----------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| `sessionId` | `string` | ✅ Sim | ID da sessão autenticada que enviará os contatos |
| `jid` | `string` | ✅ Sim | Identificador do destinatário (JID do WhatsApp). Formato: `5511999999999@s.whatsapp.net` para contatos ou `120363XXXXX@g.us` para grupos |
| `contacts` | `array` | ✅ Sim | Array de objetos de contato |
| `contacts[].displayName` | `string` | ✅ Sim | Nome de exibição do contato |
| `contacts[].vcard` | `string` | ✅ Sim | Dados do contato no formato vCard (versão 3.0) |
```json Resposta de Sucesso theme={null}
{
"success": true,
"messageId": "3EB0XXXXXX"
}
```
## Códigos de Status
* `200` - Contato(s) enviado(s) com sucesso
* `400` - Parâmetros inválidos
* `401` - Sessão não autorizada
* `404` - Sessão não encontrada
## Exemplo de Uso
```bash cURL theme={null}
curl -X POST https://api.wappfy.com.br/api/sendContactVcard \
-H "Content-Type: application/json" \
-d '{
"sessionId": "my-session",
"jid": "5511999999999@s.whatsapp.net",
"contacts": [
{
"displayName": "João Silva",
"vcard": "BEGIN:VCARD\nVERSION:3.0\nFN:João Silva\nTEL;type=CELL;type=VOICE;waid=5511988887777:+55 11 98888-7777\nEND:VCARD"
}
]
}'
```
```javascript JavaScript theme={null}
const response = await fetch('https://api.wappfy.com.br/api/sendContactVcard', {
method: 'POST',
headers: {
'Content-Type': 'application/json'
},
body: JSON.stringify({
sessionId: 'my-session',
jid: '5511999999999@s.whatsapp.net',
contacts: [
{
displayName: 'João Silva',
vcard: 'BEGIN:VCARD\nVERSION:3.0\nFN:João Silva\nTEL;type=CELL;type=VOICE;waid=5511988887777:+55 11 98888-7777\nEND:VCARD'
},
{
displayName: 'Maria Santos',
vcard: 'BEGIN:VCARD\nVERSION:3.0\nFN:Maria Santos\nTEL;type=CELL;type=VOICE;waid=5511977776666:+55 11 97777-6666\nEND:VCARD'
}
]
})
});
const data = await response.json();
console.log(data);
```
```python Python theme={null}
import requests
response = requests.post(
'https://api.wappfy.com.br/api/sendContactVcard',
json={
'sessionId': 'my-session',
'jid': '5511999999999@s.whatsapp.net',
'contacts': [
{
'displayName': 'João Silva',
'vcard': 'BEGIN:VCARD\nVERSION:3.0\nFN:João Silva\nTEL;type=CELL;type=VOICE;waid=5511988887777:+55 11 98888-7777\nEND:VCARD'
},
{
'displayName': 'Maria Santos',
'vcard': 'BEGIN:VCARD\nVERSION:3.0\nFN:Maria Santos\nTEL;type=CELL;type=VOICE;waid=5511977776666:+55 11 97777-6666\nEND:VCARD'
}
]
}
)
data = response.json()
print(data)
```
## OpenAPI
````yaml viewer.json post /api/sendContactVcard
openapi: 3.1.0
info:
title: Wappfy - WhatsApp HTTP API
version: '2.0'
contact: {}
servers:
- url: https://{host}
description: Servidor Customizável
variables:
host:
default: api.wappfy.com.br
description: 'URL do servidor (ex: api.wappfy.com.br ou seu-servidor.com)'
security:
- api_key: []
tags:
- name: 🖥️ Sessions
description: >-
Controlar sessões do WhatsApp (contas) (Control WhatsApp sessions
(accounts))
- name: 🔑 Auth
description: Autenticação
- name: 🆔 Profile
description: Informações do seu perfil
- name: 🖼️ Screenshot
description: Obter captura de tela do WhatsApp e mostrar código QR
- name: 📤 Chatting
description: Métodos de conversação
- name: 📢 Channels
description: Métodos de canais (newsletters) (Channels (newsletters) methods)
- name: 🟢 Status
description: Métodos de status (aka stories) (Status (aka stories) methods)
- name: 💬 Chats
description: Métodos de conversas
- name: 👤 Contacts
description: >-
Métodos de contatos. Use número de telefone (sem +) ou número de telefone
e `@c.us` no final como `contactId`. Ex: `12312312310` OU
`12312312310@c.us` (Contacts methods.
Use phone number (without +) or phone number and `@c.us` at the end as `contactId`.
'E.g: `12312312310` OR `12312312310@c.us`
)
- name: 👥 Groups
description: Métodos de grupos (Groups methods).
- name: ✅ Presence
description: Informações de presença
- name: 📅 Events
description: Mensagem de Evento
- name: 🏷️ Labels
description: Etiquetas - disponível apenas para contas WhatsApp Business
- name: 🔍 Observability
description: Outros métodos
- name: 🗄️ Storage
description: Métodos de armazenamento
externalDocs:
description: Wappfy - WhatsApp HTTP API
url: https://wappfy.com.br/
paths:
/api/sendContactVcard:
post:
tags:
- 📤 Chatting
operationId: ChattingController_sendContactVcard
parameters: []
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/MessageContactVcardRequest'
responses:
'201':
description: ''
security:
- api_key: []
components:
schemas:
MessageContactVcardRequest:
type: object
properties:
chatId:
type: string
description: Identificador do chat (JID do WhatsApp)
example: 5511999999999@c.us
contacts:
type: array
description: Array de contatos no formato vCard
items:
oneOf:
- $ref: '#/components/schemas/VCardContact'
- $ref: '#/components/schemas/Contact'
reply_to:
type: string
description: ID da mensagem à qual você deseja responder
example: null
session:
type: string
example: my-session
description: Nome da sessão (instanceName)
required:
- chatId
- contacts
- session
VCardContact:
type: object
properties:
vcard:
type: string
example: |-
BEGIN:VCARD
VERSION:3.0
FN:Jane Doe
ORG:Company Name;
TEL;type=CELL;type=VOICE;waid=911111111111:+91 11111 11111
END:VCARD
description: String vCard do contato
required:
- vcard
Contact:
type: object
properties:
fullName:
type: string
example: John Doe
description: Nome completo do contato
organization:
type: string
example: Company Name
description: Organização do contato
phoneNumber:
type: string
example: +91 11111 11111
description: Número de telefone do contato
whatsappId:
type: string
example: '911111111111'
description: The whatsapp id of the contact. DO NOT add + or @c.us
vcard:
type: string
default: null
required:
- fullName
- phoneNumber
- vcard
securitySchemes:
api_key:
type: apiKey
in: header
name: apikey
description: Sua chave de API do Wappfy (obtenha em dash.wappfy.com.br)
````