Contacts

Joindre des contacts

La page Contacts

Contenu d'un contact

Propriétés de contact

• La clé est le nom qui permet de référencer la valeur, par exemple plan_tier. Elle doit être en minuscules et commencer par une lettre (^[a-z][a-z0-9_]*$), et elle ne peut plus changer après sa création.
• Le type est l'un des suivants : string, number, boolean ou datetime. Il est lui aussi fixé à la création. Un datetime accepte un horodatage RFC 3339 avec un décalage explicite, comme 2026-01-15T11:30:00+02:00, que nous normalisons en UTC à la seconde près. Cette valeur est donc enregistrée et renvoyée sous la forme 2026-01-15T09:30:00Z. Une date seule, sans heure, est refusée. Le tableau de bord les désigne par Texte, Nombre, Vrai / faux et Date et heure.
• La valeur de repli est celle lue pour un contact qui n'a pas de valeur propre. Ainsi, l'absence de plan_tier peut renvoyer free plutôt qu'une valeur vide.

Importer et synchroniser des contacts

const contact = await bird.contacts.create({
  email: "jane@acme.com",
  first_name: "Jane",
});
console.log(contact.id); // "con_…"

contact = client.contacts.create(email="jane@acme.com", first_name="Jane")
print(contact.id, contact.email)

contact, err := client.Contacts.Create(context.Background(), bird.ContactCreateParams{
	Email:     bird.Ptr("jane@acme.com"),
	FirstName: bird.Ptr("Jane"),
})
if err != nil {
	log.Fatal(err)
}
fmt.Println(contact.Id)

$contact = $bird->contacts->create(
    (new ContactCreateRequest())
        ->setEmail('jane@acme.com')
        ->setFirstName('Jane'),
);
echo $contact->getId(); // "con_…"

bird contacts create alice@acme.com \
  --first-name Alice \
  --last-name Anderson \
  --phone-number +31612345678

{
  "name": "contacts_create",
  "arguments": {
    "email": "alice@acme.com",
    "first_name": "Alice",
    "last_name": "Anderson",
    "phone_number": "+31612345678"
  }
}

curl -X POST "https://{region}.platform.bird.com/v1/contacts" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "alice@acme.com",
    "phone_number": "+31612345678",
    "first_name": "Alice",
    "last_name": "Anderson"
  }'

{
  "data": [
    {
      "contact_id": "con_01ky7q5t51echr7mqj5c08423b",
      "entry": { "email": "alex@example.com", "phone_number": null, "external_id": null },
      "matched_on": "email",
      "status": "updated"
    },
    {
      "contact_id": "con_01ky7q6mxdfhe86c9dqyt866pz",
      "entry": { "email": "jamie@example.com", "phone_number": null, "external_id": null },
      "matched_on": null,
      "status": "created"
    },
    {
      "contact_id": "con_01ky7q7rv9e9pt4vkr0w0gxq5e",
      "entry": { "email": "casey@example.com", "phone_number": null, "external_id": "user_2214" },
      "matched_on": "external_id",
      "status": "updated"
    }
  ]
}

Supprimer un contact

Étapes suivantes

• Audiences : regrouper des contacts dans des listes réutilisables
• Suppressions : la liste des adresses de l'espace de travail auxquelles nous ne livrons pas de messages, distincte de vos contacts
• Envoi par lots : joindre plusieurs destinataires en un seul appel, jusqu'à 100 messages par requête
• CLI : automatiser les contacts, les propriétés et les audiences par script avec la commande bird
• Référence de l'API : les schémas complets des requêtes et des réponses